feat: complete M2 content workspace and inspector
No files matched your search
@@ -0,0 +1,9 @@
|
||||
# Documentation subtree rules
|
||||
|
||||
- Read `docs/authority.toml` before treating a document as current.
|
||||
- Canonical docs describe current behavior; active plans describe incomplete work; accepted ADRs
|
||||
describe decisions and constraints; evaluations describe dated evidence.
|
||||
- Historical and superseded documents are not current requirements.
|
||||
- Do not duplicate detailed contracts across README, guides, plans, ADRs, and tracker bodies.
|
||||
- Update the smallest canonical surface that owns the changed behavior.
|
||||
- Run `scripts/codex/docs_audit.py` through the documentation-integrity workflow.
|
||||
@@ -1,14 +1,27 @@
|
||||
# Project Documentation
|
||||
|
||||
Central index for design decisions, mission, and editor framework docs. Agents and contributors should keep this map current—see [`.cursor/rules/documentation.mdc`](../.cursor/rules/documentation.mdc).
|
||||
Central index for design decisions, mission, editor framework docs, and repository workflow.
|
||||
Before treating any document as current guidance, read [`authority.toml`](authority.toml).
|
||||
|
||||
## Core
|
||||
|
||||
| Document | Purpose |
|
||||
|----------|---------|
|
||||
| [authority.toml](authority.toml) | Machine-readable current/plan/evidence/historical/superseded classification |
|
||||
| [mission.md](mission.md) | Why the editor framework exists, principles, audience, non-goals |
|
||||
| [../README.md](../README.md) | Run/build instructions, controls, implementation checklist |
|
||||
|
||||
## Repository workflow
|
||||
|
||||
| Document | Purpose |
|
||||
|----------|---------|
|
||||
| [workflow/codex-workflow.md](workflow/codex-workflow.md) | Task lifecycle, scope deltas, and completion states |
|
||||
| [workflow/documentation-policy.md](workflow/documentation-policy.md) | Authority hierarchy, lifecycle classes, and integrity audit |
|
||||
| [workflow/verification-policy.md](workflow/verification-policy.md) | Fast, slice, and candidate verification tiers |
|
||||
| [workflow/build-storage-policy.md](workflow/build-storage-policy.md) | Managed Cargo lanes, budgets, and safe pruning |
|
||||
| [workflow/gitea-tracking-policy.md](workflow/gitea-tracking-policy.md) | Tracker state and mutation boundaries |
|
||||
| [archive/](archive/) | Preserved non-current documentation records |
|
||||
|
||||
## Architecture Decision Records (ADRs)
|
||||
|
||||
Immutable-style log of significant decisions. Add a new numbered ADR when changing boundaries, formats, or policies.
|
||||
@@ -59,15 +72,21 @@ Immutable-style log of significant decisions. Add a new numbered ADR when changi
|
||||
| [0042](adr/0042-guarded-editor-shutdown-and-document-savepoints.md) | Guarded native editor exit and canonical per-document clean checkpoints |
|
||||
| [0043](adr/0043-content-addressed-import-fingerprints.md) | Content-addressed imported-source identity and byte-preserving artifact publication |
|
||||
| [0044](adr/0044-sandboxed-fbx-external-texture-dependencies.md) | Sandboxed FBX texture bundles, validation policy, and deduplicated loading |
|
||||
| [0045](adr/0045-content-workspace-and-material-fallback-contract.md) | Path-agnostic content workspace, registry v3, model material defaults, and DefaultGrid fallback |
|
||||
| [0046](adr/0046-schema-driven-material-inputs-and-processed-textures.md) | Schema-driven Material inputs, registry v3 Texture settings, ARM packing, and deterministic runtime textures |
|
||||
| [0047](adr/0047-editor-authored-asset-documents.md) | Editor-dirty asset documents, explicit saves, recovery, and background derived publication |
|
||||
| [0048](adr/0048-modular-editor-composition-and-debt-ratchet.md) | Thin editor composition, registry-only Inspector dispatch, and automated architecture debt ratchet |
|
||||
| [0049](adr/0049-penpot-led-editor-visual-system.md) | Penpot-led visual tokens, responsive editor components, Source Sans Pro typography, and picker interaction |
|
||||
|
||||
## Editor framework
|
||||
|
||||
| Document | Purpose |
|
||||
|----------|---------|
|
||||
| [editor/release-notes.md](editor/release-notes.md) | Editor framework 1.0 baseline |
|
||||
| [editor/evaluations/](editor/evaluations/) | Acceptance records, screenshots, and Gitea evidence-publishing policy |
|
||||
| [editor/release-notes.md](editor/release-notes.md) | Historical editor framework 1.0 snapshot |
|
||||
| [editor/evaluations/](editor/evaluations/) | Dated acceptance evidence and Gitea evidence-publishing policy; not product specification |
|
||||
| [editor/architecture.md](editor/architecture.md) | Viewport / PIE / settings data flow |
|
||||
| [editor/visual-language.md](editor/visual-language.md) | Editor chrome, viewport, selection, gizmo, and visualizer language |
|
||||
| [editor/design-system.md](editor/design-system.md) | Penpot-led visual tokens, reusable controls, responsive geometry, and material-inspector presentation |
|
||||
| [editor/roadmap.md](editor/roadmap.md) | Phased editor roadmap and status |
|
||||
| [editor/brp.md](editor/brp.md) | BRP automation and authoring-only policy |
|
||||
| [editor/debt-audit.md](editor/debt-audit.md) | Zero-debt phase gates |
|
||||
@@ -83,6 +102,7 @@ Immutable-style log of significant decisions. Add a new numbered ADR when changi
|
||||
| [editor/navigation-authoring.md](editor/navigation-authoring.md) | Bounds/obstacles/areas/links, deterministic bake, overlay, path preview, and runtime queries |
|
||||
| [editor/extensibility.md](editor/extensibility.md) | Static authoring component registration, lifecycle, composition, and history contract |
|
||||
| [editor/material-system.md](editor/material-system.md) | Shared material assets and instances, renderer-slot assignment, Surface evaluators, migration, and diagnostics |
|
||||
| [editor/content-workspace.md](editor/content-workspace.md) | File-manager content organization, destination-first import, stable IDs, and model material authoring |
|
||||
| [editor/collaborative-file-safety.md](editor/collaborative-file-safety.md) | Guarded authored writes, compact Git/read-only status, conflict recovery, and ownership providers |
|
||||
| [editor/native-dialogs.md](editor/native-dialogs.md) | Non-blocking native dialog acquisition and main-thread result application |
|
||||
| [editor/terrain.md](editor/terrain.md) | Terrain schema, inspector workflow, chunk hydration, collision, and follow-on boundaries |
|
||||
@@ -101,33 +121,20 @@ Immutable-style log of significant decisions. Add a new numbered ADR when changi
|
||||
| [editor/evaluations/scoped-ui-actions/](editor/evaluations/scoped-ui-actions/) | Exact-implementation source and native acceptance evidence for actions invoked during scoped egui rendering |
|
||||
| [editor/evaluations/deterministic-asset-fingerprints/](editor/evaluations/deterministic-asset-fingerprints/) | Source, fresh-checkout, hash-stability, and native acceptance evidence for imported-source fingerprints |
|
||||
| [editor/evaluations/fbx-external-texture-dependencies/](editor/evaluations/fbx-external-texture-dependencies/) | Source, validation, and native acceptance evidence for sandboxed FBX texture dependencies and override states |
|
||||
| [editor/evaluations/content-workspace-m2/](editor/evaluations/content-workspace-m2/) | Native M2 evidence for Content Browser file-manager selection, context menus, managed-folder visibility, and Details resizing |
|
||||
| [editor/evaluations/production-readiness/](editor/evaluations/production-readiness/) | Current versioned production gate, evidence matrix, candidate commands, soak protocol, and independent sign-off requirements |
|
||||
|
||||
## Working plans (not canonical long-term)
|
||||
## Plans
|
||||
|
||||
Detailed milestone and feature plans live in [`.cursor/plans/`](../.cursor/plans/). Promote stable outcomes into ADRs or `docs/` when shipped.
|
||||
Plans describe desired scope and acceptance, never current implementation truth. Their authoritative
|
||||
classification is in [`authority.toml`](authority.toml); completed plans are frozen as historical
|
||||
records instead of being rewritten as status diaries.
|
||||
|
||||
| Plan | Topic |
|
||||
|------|-------|
|
||||
| `project_roadmap_*.plan.md` | M0–M8 program index |
|
||||
| `editor_framework_mission_roadmap_*.plan.md` | Editor mission + phased roadmap |
|
||||
| `project_settings_and_pie_eject_*.plan.md` | M1.5: settings, rendering parity, PIE eject |
|
||||
| `rendering_unification_*.plan.md` | Unified rendering stack, Hybrid Auto GI, emissive materials |
|
||||
| `static_mesh_asset_refactor_*.plan.md` | Static mesh renderer, normalized model artifacts, inspector redesign |
|
||||
| `component_system_refactor_*.plan.md` | Component registry, imported asset refs, collider split, material overrides |
|
||||
| `jackdaw_feature_roadmap_*.plan.md` | Jackdaw-inspired production roadmap; tracked in Gitea as `BS-JD-*` issues |
|
||||
| `blacksite_production_readiness_*.plan.md` | M6-M7 reliability, content production, shipping, and acceptance gates |
|
||||
| `animation_authoring_*.plan.md` | M7 glTF skeletal animation import, preview, controller, and runtime acceptance |
|
||||
| `navigation_authoring_*.plan.md` | M7 navigation bounds, deterministic bake, diagnostics, preview, and runtime query API |
|
||||
| `renderer_material_component_foundation_*.plan.md` | Renderer/material slots, skinned pose lifecycle, Surface ABI, and component foundation |
|
||||
| `source_control_collaboration_safety_*.plan.md` | Exact authored-file guards, observational Git status, conflict recovery, and provider contract |
|
||||
| `production_readiness_acceptance_*.plan.md` | Release-candidate evidence matrix, blocker sequence, clean-checkout checks, soak, budgets, and independent sign-off |
|
||||
| `material_library_and_targeted_drop_*.plan.md` | Dedicated Material Library, exact viewport slot/primitive/brush targeting, hover preview, cancel, and grouped history |
|
||||
| `terrain_material_layers_*.plan.md` | Terrain shared-material layers, normalized weights, blended hydration, and modal painting |
|
||||
| `operator_invariants_completion_*.plan.md` | Production operator dispatch, interruption, rollback, cleanup, and undo/redo acceptance |
|
||||
| `editor_sample_regression_pack_*.plan.md` | Five-area sample manifest, editor catalog, deterministic validation, and native regression acceptance |
|
||||
| `guarded_shutdown_savepoints_*.plan.md` | Native close coordination, asynchronous Save All, and canonical history clean points |
|
||||
| `fbx_external_texture_dependencies_*.plan.md` | Sandboxed FBX sidecar discovery, import transactions, validation, loader behavior, and Asset Browser states |
|
||||
Current active plans:
|
||||
|
||||
- [Content workspace and import authoring](../.cursor/plans/content_workspace_and_import_authoring_2026-07-13.plan.md)
|
||||
- [Production-readiness program](../.cursor/plans/blacksite_production_readiness_2026-07-10.plan.md)
|
||||
- [Production-readiness acceptance gate](../.cursor/plans/production_readiness_acceptance_2026-07-12.plan.md)
|
||||
|
||||
## Crate responsibilities (quick reference)
|
||||
|
||||
@@ -135,6 +142,7 @@ Detailed milestone and feature plans live in [`.cursor/plans/`](../.cursor/plans
|
||||
crates/protocol/ Tick rate, input intent, message shapes
|
||||
crates/sim/ Fixed-step gameplay; no rendering
|
||||
crates/shared/ Authoring components + hydration
|
||||
crates/content_pipeline/ UI-independent content catalog, transaction, import, and processing engine
|
||||
crates/game/ Client presentation, GamePlugin, rendering
|
||||
crates/editor/ In-process egui editor, BRP, PIE
|
||||
crates/settings/ Project settings, active/effective render profile contracts
|
||||
|
||||
@@ -23,6 +23,12 @@ The editor has one primary **Viewport** tab backed by one HDR `ViewportRenderTar
|
||||
transform gizmos, visualizers, and selectable proxies without changing camera ownership.
|
||||
- `Ctrl+G` toggles the grid.
|
||||
- Saved dock layouts containing the old Game View tab are migrated to one Viewport tab.
|
||||
- Ordinary dock and Inspector resizing mutates the existing HDR Image asset's extent while keeping
|
||||
its stable asset ID. Egui owns exactly one strong registration for that ID; an exceptional target
|
||||
replacement or absent/collapsed target explicitly unregisters the previous image.
|
||||
- The editor host window prefers a non-FIFO presentation path (`AutoNoVsync`) so interactive
|
||||
NVIDIA/Wayland window resizing cannot wedge the UI behind repeated one-second swapchain-acquire
|
||||
timeouts. Packaged game windows retain `AutoVsync`.
|
||||
- Multi-viewport support is represented as future-facing state/API shape only; secondary visible
|
||||
viewports remain future work.
|
||||
|
||||
@@ -32,6 +38,10 @@ The editor has one primary **Viewport** tab backed by one HDR `ViewportRenderTar
|
||||
- Camera ownership is explicit: F8 possession selects player camera vs editor camera; G only hides
|
||||
editor overlays.
|
||||
- The HDR/swapchain invariant remains centralized around one offscreen viewport target.
|
||||
- Repeated splitter movement has bounded render-target ownership instead of retaining one
|
||||
full-resolution HDR image per intermediate panel width.
|
||||
- Repeated native-window resizing remains interactive even when the compositor cannot immediately
|
||||
supply a FIFO swapchain image; this editor-specific latency choice does not change game VSync.
|
||||
- Future secondary viewports should add viewport-id keyed rects, targets, cameras, and overlay state
|
||||
rather than reintroducing a Scene View/Game View split.
|
||||
- Post-FX and GI on the active viewport camera are owned by `game_hot::rendering::viewport_camera`
|
||||
|
||||
@@ -12,51 +12,81 @@ copies per actor, and left rigged geometry without the same assignment model as
|
||||
Matching imported materials by a display name was also unsafe: names are neither unique nor stable
|
||||
when a model is reimported.
|
||||
|
||||
Static and skinned renderers need the same Unity-like authoring contract without sharing their mesh
|
||||
or hydration components. A project material must be reusable, an instance must express explicit
|
||||
overrides over one base material, and each renderer must expose stable material slots independently
|
||||
from its draw or skeleton representation.
|
||||
Primitives, static renderers, and skinned renderers need the same Unity-like authoring contract
|
||||
without sharing their geometry or hydration components. A project material must be reusable, an
|
||||
instance must express explicit overrides over one base material, and every renderable surface must
|
||||
expose stable material slots independently from its draw or skeleton representation.
|
||||
|
||||
## Decision
|
||||
|
||||
- Project materials use versioned `MaterialAsset` documents. A `MaterialInstanceAsset` references
|
||||
one direct base `MaterialAsset` and stores parameter and texture overrides. Nested material
|
||||
instances are invalid.
|
||||
instances are invalid. Schema-driven input storage and processed Texture bindings are defined by
|
||||
[ADR 0046](0046-schema-driven-material-inputs-and-processed-textures.md).
|
||||
- `MaterialRef` is the assignment type. Its registry UUID and subasset ID are authoritative;
|
||||
`source_path` is a cached loading hint that validation or migration may repair after a move.
|
||||
- `StaticMeshRenderer` and `SkinnedMeshRenderer` each own a `RendererMaterialSet`. They do not share
|
||||
a mesh component or hydration path. Each `RendererMaterialSlot` has a stable ID, a presentation
|
||||
name, a read-only imported `source_material`, and an optional explicit `material` assignment.
|
||||
Explicit assignment wins; clearing it returns to the imported source material.
|
||||
- `Primitive`, `StaticMeshRenderer`, and `SkinnedMeshRenderer` own `MaterialSlot` values. Mesh
|
||||
renderers use a `MaterialSlotSet`; a primitive owns one stable `surface` slot with ID
|
||||
`slot:primitive:surface`. They do not share a geometry component or hydration path. Each saved
|
||||
slot has a stable ID, a presentation name, and only an optional actor/prefab `material`
|
||||
assignment. Model defaults and imported source materials remain asset-owned in model import
|
||||
metadata and runtime manifests. Clearing an actor assignment returns resolution to those weaker
|
||||
model-owned layers.
|
||||
- Static draw parts and imported skinned-hierarchy draws bind to material slots by stable IDs.
|
||||
Reimport reconciles by ID only. An explicit assignment whose source slot disappears is retained as
|
||||
an `OrphanedMaterialAssignment`; the editor never silently reconnects it by display name.
|
||||
- Asset Browser **Apply Material** assigns a shared material or material instance to every material
|
||||
slot on each selected static or skinned renderer. Renderer inspectors provide per-slot
|
||||
Browse/Select/Locate/Clear controls and expose orphan warnings.
|
||||
- `HydratedRendererMaterialBinding` identifies each runtime draw's owner, slot, and effective
|
||||
material. A skinned renderer material-only edit patches the instantiated hierarchy without
|
||||
reloading its source hierarchy or joints.
|
||||
- Asset Browser **Apply Material** assigns a shared material or material instance to a selected
|
||||
primitive surface or every material slot on each selected static/skinned renderer. One inspector
|
||||
widget provides drag/drop, Browse/Locate/Clear, inherited status, expandable shared parameters,
|
||||
exact-slot extraction, and orphan diagnostics.
|
||||
- `HydratedMaterialSlotBinding` identifies each runtime draw's owner and exact slot.
|
||||
`HydratedMaterialSelection` carries Project Actor, Project Model, Imported Source, or Inherit
|
||||
ownership without copying model defaults into the scene. A skinned renderer material-only edit
|
||||
patches the instantiated hierarchy without reloading its source hierarchy or joints.
|
||||
- `MaterialPropertyBlocks` are runtime-only, per-slot overrides. They do not mutate a shared asset
|
||||
and are excluded from scene and prefab persistence. Persisting a reusable variation requires an
|
||||
explicit material instance.
|
||||
- Scene schema v4 migrates legacy renderer assignments into `RendererMaterialSet`. Project material,
|
||||
material-instance, shader-schema, and scene rewrites are performed by the explicit transactional
|
||||
`cargo upgrade-project` command; ordinary loading remains read-only.
|
||||
- Model assets may provide a project Material/Instance default between their imported source and a
|
||||
scene/prefab assignment. The terminal fallback chain and immutable DefaultGrid contract are owned
|
||||
by [ADR 0045](0045-content-workspace-and-material-fallback-contract.md).
|
||||
- Effective precedence is runtime MaterialPropertyBlock, scene/prefab assignment, model-asset
|
||||
default, imported source, project default, then built-in DefaultGrid. A configured but broken
|
||||
authored reference uses the fallback with diagnostics instead of silently exposing another
|
||||
authored layer.
|
||||
- Repository scenes use schema v6, where renderable slots persist actor/prefab assignments only.
|
||||
This pre-production project updates its fixtures directly. The explicit project upgrader remains
|
||||
available for legacy primitive `MaterialDesc`, mesh-wide descriptors, and per-slot
|
||||
`MaterialOverride` values: it deduplicates canonical descriptors as deterministic project
|
||||
Materials under `assets/materials/migrated/` and rewrites project references transactionally.
|
||||
Ordinary loading remains non-writing.
|
||||
|
||||
## Consequences
|
||||
|
||||
- Static and skinned renderers have a consistent material-slot workflow while retaining distinct
|
||||
geometry ownership and hydration behavior.
|
||||
- Primitives, static renderers, and skinned renderers have one material-slot workflow while
|
||||
retaining distinct geometry ownership and hydration behavior.
|
||||
- An assignment remains a reference rather than a copied material value, so editing or replacing a
|
||||
shared asset does not create actor-local material copies. Material/base/schema/evaluator
|
||||
dependency revisions update the shared runtime handle in place across all assigned slots.
|
||||
- Source reimport cannot silently move an override to the wrong draw. Orphans require an explicit
|
||||
user decision to reassign or discard.
|
||||
- Legacy primitive/actor `MaterialDesc` paths remain compatibility paths until their consumers move
|
||||
to renderer slots; new mesh-renderer work uses shared references.
|
||||
- `MaterialPropertyBlocks` currently define the runtime-only schema and persistence exclusion, but
|
||||
renderer application and the editor promote-to-instance transaction are not implemented. Gitea
|
||||
#53 owns that complete workflow; callers must not treat the component as visibly applied yet.
|
||||
- Material graph authoring, nested instances, blended/transmissive materials, and a generalized
|
||||
per-renderer property-block inspector are outside this decision.
|
||||
- Component-form `MaterialDesc` is restricted to the brush fallback compatibility path. It is not
|
||||
addable to primitives or mesh renderers, does not override their slots, and never causes a
|
||||
primitive-local runtime material allocation. Unmigrated actor material components produce an
|
||||
upgrade diagnostic and visible fallback.
|
||||
- `MaterialPropertyBlocks` define the runtime-only schema and persistence exclusion. Runtime
|
||||
application clones and caches the resolved Standard or Surface material per owner/slot, above
|
||||
direct-base Material Instance values. An invalid block leaves the resolved base visible and emits
|
||||
a deduplicated diagnostic instead of applying a partial override. Promotion to a reusable
|
||||
instance uses an explicit target-path review and source/target fingerprint guards, assigns one
|
||||
exact slot through history, and clears the block only after the file, registry, and scene
|
||||
transaction succeeds. It may never use DefaultGrid as its base. The editor registers the
|
||||
component with reflection for trusted local BRP runtime injection and native promotion testing;
|
||||
that registration does not add it to authoring persistence or the Inspector component registry.
|
||||
- Material graph authoring, nested instances, and blended/transmissive materials are outside this
|
||||
decision.
|
||||
|
||||
Scene schema v6 stores only the actor/prefab assignment in a renderable slot. Model defaults and
|
||||
imported source selections remain model-owned, and hydration carries their origin through
|
||||
`HydratedMaterialSelection`. Live project resolution is owned solely by the overlay/cache boundary
|
||||
in [ADR 0047](0047-editor-authored-asset-documents.md); shared slot presentation follows
|
||||
[ADR 0048](0048-modular-editor-composition-and-debt-ratchet.md).
|
||||
@@ -31,6 +31,8 @@ lighting, fog, shadows, and render-pipeline bindings under engine ownership.
|
||||
`SurfaceInput` provides UV0, world position, and world normal. `Surface` returns base color,
|
||||
tangent-space normal, emissive, metallic, perceptual roughness, reflectance, occlusion, alpha,
|
||||
and lit/unlit model selection.
|
||||
- The schema-driven authoring inputs and canonical processed Texture/ARM artifacts feeding this ABI
|
||||
are defined by [ADR 0046](0046-schema-driven-material-inputs-and-processed-textures.md).
|
||||
- The ABI has 16 `vec4` parameter lanes, eight sampled 2D texture slots with UV transforms, and a
|
||||
400-byte `SurfaceUniform`. Shader schemas map typed Bool/Float/Vec2/Vec3/Color/Enum properties and
|
||||
texture properties into that fixed layout. Exceeding either limit is a validation error.
|
||||
|
||||
@@ -51,3 +51,5 @@ provider.
|
||||
- Native filesystem replacement cannot coordinate with unrelated writers that ignore advisory
|
||||
conventions after Blacksite's final revision check; the narrow check-to-rename interval is the
|
||||
platform boundary, and deterministic race hooks cover the editor-controlled interval.
|
||||
- [ADR 0047](0047-editor-authored-asset-documents.md) applies these guards at explicit asset Save
|
||||
boundaries; interactive parameter edits never enter the authored-file publication path.
|
||||
@@ -55,3 +55,5 @@ tabs switch, while saves may establish a clean point in the middle of a timeline
|
||||
direct non-history repairs, entity respawns, and tab switches.
|
||||
- Operating-system process kill and power loss cannot be confirmed; recovery and abnormal-session
|
||||
handling remain the safety boundary for those cases.
|
||||
- [ADR 0047](0047-editor-authored-asset-documents.md) extends the guarded decision to dirty asset
|
||||
documents and project settings while derived processing remains resumable after source save.
|
||||
@@ -16,8 +16,8 @@ paths more than once.
|
||||
Import, manifest generation, project validation, editor previews, and the runtime loader must agree
|
||||
on one dependency graph. That graph also crosses a security boundary: an imported source must not
|
||||
read or copy a parent-traversing path or an arbitrary absolute path outside its bundle. A missing
|
||||
source texture is required when Source Materials is active, but it can be an intentional authoring
|
||||
condition when an asset explicitly uses Authoring Override.
|
||||
source texture is required when any stable model slot selects Source, but it can be an intentional
|
||||
authoring condition when every slot selects a project Material/Instance or Default.
|
||||
|
||||
## Decision
|
||||
|
||||
@@ -36,8 +36,10 @@ loader warning instead of deferred asset-server requests.
|
||||
Static-mesh manifests are the authoritative model import dependency graph. Their existing
|
||||
`source.dependencies` list records every parsed FBX external texture, including unavailable files.
|
||||
Project validation checks that list without loading native assets. Missing FBX textures are a
|
||||
blocking consolidated finding under Source Materials and an informational consolidated finding
|
||||
under Authoring Override. Unsafe paths remain blocking under either policy. Model registry records
|
||||
blocking consolidated finding while any slot selects Source and an informational consolidated
|
||||
finding when every slot selects Project/Default. The former whole-model Authoring Override value is
|
||||
accepted only as registry-v1 migration input and expands to explicit Default selections. Unsafe
|
||||
paths remain blocking under either selection state. Model registry records
|
||||
mirror the list for editor details, but validation does not duplicate it when a generated static
|
||||
manifest exists.
|
||||
|
||||
@@ -50,16 +52,17 @@ Unreferenced `.fbm` contents are not copied.
|
||||
The Asset Browser renders FBX model and mesh thumbnails through the neutral direct mesh path.
|
||||
Source-material thumbnails preflight the authoritative dependency resolver first and cache one
|
||||
non-retryable actionable failure when required textures are unavailable. Dependency rows expose
|
||||
present/missing state. The committed painted-chair fixture uses Authoring Override deliberately and
|
||||
remains untextured; its three source paths stay visible in manifests, validation, and asset details.
|
||||
present/missing state. The committed painted-chair fixture's legacy Authoring Override migrates to
|
||||
per-slot Default selections and remains untextured; its three source paths stay visible in
|
||||
manifests, validation, and asset details.
|
||||
|
||||
## Consequences
|
||||
|
||||
- FBX sibling `textures/` and `.fbm/` bundles import and validate with identical normalized paths.
|
||||
- Missing texture files are visible before native loading and cannot create repeated Bevy
|
||||
asset-server errors.
|
||||
- Source Materials fails release validation when its FBX textures are absent. Authoring Override
|
||||
remains release-valid but retains an informational dependency finding.
|
||||
- Any Source slot fails release validation when its FBX textures are absent. An all-Project/Default
|
||||
model remains release-valid but retains an informational dependency finding.
|
||||
- Absolute exporter paths, traversal attempts, and destination symlink redirects cannot read or
|
||||
copy arbitrary host files.
|
||||
- FBX files with external textures are parsed twice during loading so no non-`Send` ufbx scene
|
||||
|
||||
@@ -0,0 +1,90 @@
|
||||
# ADR 0045: Content Workspace and Material Fallback Contract
|
||||
|
||||
## Status
|
||||
|
||||
Accepted
|
||||
|
||||
## Context
|
||||
|
||||
Blacksite's Content Browser scans the project `assets/` tree, but authored RON type detection and
|
||||
import destinations still depend on conventional folders. The asset registry is editor-owned and
|
||||
serialized as an unversioned record list, so validation, packaging, runtime hydration, and future
|
||||
headless processing duplicate parts of its contract. Imported model materials are either read-only
|
||||
source defaults or scene-level assignments; a model asset cannot own editable project defaults.
|
||||
|
||||
Missing renderer materials currently create separate magenta `StandardMaterial` values, while
|
||||
skinned, primitive, brush, terrain, thumbnail, raster, and Solari paths use different fallback
|
||||
rules. A missing or broken material therefore does not have one predictable, production-safe
|
||||
result.
|
||||
|
||||
## Decision
|
||||
|
||||
- User-authored content may live in any normal nested folder beneath the project `assets/` root.
|
||||
Folder names are organizational only. External absolute linked assets are not supported.
|
||||
- `AssetId` is authoritative identity. Project-relative paths and labels are repairable cached
|
||||
metadata. Moves and reimports reconcile by stable IDs and never by display name.
|
||||
- Registry contracts move to `shared::content`: typed asset kinds, versioned registry documents,
|
||||
project content defaults, import settings, model material policies, and runtime catalog records.
|
||||
UI-independent filesystem scanning, classification, transaction planning, import/reimport, and
|
||||
processing live in a `content_pipeline` crate used by the editor, validator, watcher, and xtask.
|
||||
- Registry schema v3 is `AssetRegistryDocument { schema_version, defaults, records }` with typed
|
||||
Model/Texture import settings as extended by [ADR 0046](0046-schema-driven-material-inputs-and-processed-textures.md). The source
|
||||
registry remains editor-managed under `assets/.index/`; packages receive a stripped runtime
|
||||
catalog without editor import provenance or source-only dependencies.
|
||||
- Project content roots normalize to `assets/`. `.index`, `.trash`, thumbnails, recovery data, and
|
||||
implementation-owned derived artifacts are hidden and protected from normal file operations.
|
||||
- Fixed-folder consumers are retired or explicitly constrained as follows:
|
||||
|
||||
| Consumer | Current contract / migration |
|
||||
|----------|------------------------------|
|
||||
| Project settings and templates | `asset_roots` upgrades to exactly `["assets"]`; the explicit project upgrader performs the write. |
|
||||
| Content Browser and registry scanner | Walk all user-managed descendants and classify by extension plus document schema, never by parent folder. |
|
||||
| Material, shader, model, audio, level, and prefab lookup | Resolve the registry's stable ID to its current path; a cached path is a repair hint only. |
|
||||
| Scene/prefab validation and hydration | Consume registry/runtime-catalog resolution rather than conventional authoring directories. |
|
||||
| Packaging and headless processing | Scan the same content root and publish the same stripped catalog and normalized model manifests. |
|
||||
| Material creation UX | The current browser folder is authoritative; `assets/materials/` remains only a Material Library convenience default. |
|
||||
| Generated mesh, animation, navigation, thumbnail, trash, and index data | Their fixed implementation-owned locations remain hidden managed storage, excluded from user classification and ordinary file operations. |
|
||||
|
||||
- Model material selections are per stable slot: Source, Project Material/Instance, or Default.
|
||||
Extracting a source material creates an ordinary project Material and then stores a Project
|
||||
selection. Re-extraction may replace a provenance-matched Material only after an explicit diff
|
||||
and fingerprint-guarded Apply decision; Create New remains available and unrelated provenance is
|
||||
never overwritten. Reimport retains removed project assignments as explicit orphans.
|
||||
- Effective material precedence, strongest first, is: runtime MaterialPropertyBlock, scene/prefab
|
||||
assignment, model-asset default, imported source, project default, built-in DefaultGrid. Missing
|
||||
layers inherit downward. A configured but broken authored reference renders the fallback and
|
||||
reports the broken layer rather than silently revealing a different authored layer.
|
||||
- Primitive surfaces participate in that same chain through their saved
|
||||
`slot:primitive:surface`; they no longer hydrate from a separate actor-local descriptor. Static
|
||||
and skinned draws bind their exact saved slot IDs through the same runtime binding contract.
|
||||
- DefaultGrid is immutable engine content compiled into the renderer. It is a shared,
|
||||
UV-independent world-space checker with raster/Solari parity and a neutral StandardMaterial
|
||||
emergency path. A project may choose a Material/Instance fallback; clearing or breaking it
|
||||
returns to DefaultGrid. Terrain retains its specialized layer fallback.
|
||||
- Built-in DefaultGrid is not editable, instanceable, or a valid MaterialPropertyBlock promotion
|
||||
base. Promotion requires a resolved project or imported Material base.
|
||||
- Ordinary editor/runtime loading is read-only. Registry, project-settings, and scene migrations
|
||||
run only through the explicit transactional project upgrader.
|
||||
|
||||
## Consequences
|
||||
|
||||
- Editor, runtime, validation, packaging, watcher, and headless processing share one content model
|
||||
and one stable-ID resolver.
|
||||
- Arbitrary organization no longer changes asset type, runtime behavior, or package inclusion.
|
||||
- The content pipeline becomes a reusable crate boundary instead of an editor implementation
|
||||
detail; this adds one workspace crate and moves registry types out of `editor`.
|
||||
- Older registries, conventional asset roots, global model material policy, and legacy mesh material
|
||||
overrides require the explicit transactional upgrader; normal loading accepts current schemas.
|
||||
- Broken assignments stay visible and diagnosable, but may look different from their previous
|
||||
imported source because failure uses the project/engine fallback deliberately.
|
||||
- One cached DefaultGrid/emergency handle covers repeated primitive and mesh hydration, so missing
|
||||
assignments do not grow the material asset stores.
|
||||
- Thumbnail cache ownership includes the backing Egui image registration. Replacement, retry, and
|
||||
catalog invalidation explicitly release the last registration before a new studio render owns
|
||||
the key, preventing refresh-driven GPU resource growth.
|
||||
- File operations and imports must be staged transactions that update authored references,
|
||||
registry state, derived manifests, and runtime catalogs together.
|
||||
- Ordinary asset-property edits use the explicit dirty-document and two-phase publication boundary
|
||||
defined by [ADR 0047](0047-editor-authored-asset-documents.md); topology transactions remain immediate.
|
||||
- Scene schema v6 carries actor/model/imported/inherit origin explicitly at hydration time, so a
|
||||
broken authored layer uses DefaultGrid instead of accidentally revealing a weaker layer.
|
||||
@@ -0,0 +1,55 @@
|
||||
# ADR 0046: Schema-driven material inputs and processed textures
|
||||
|
||||
## Status
|
||||
|
||||
Accepted
|
||||
|
||||
## Context
|
||||
|
||||
The first Material asset format stored a resolved `MaterialDesc` plus a second generic parameter
|
||||
list. The editor consequently rendered Standard Lit twice, could not pair a scalar or color with its
|
||||
texture, and had no stable place to describe future shader-graph inputs. Texture files also carried
|
||||
no import intent, so color maps, normals, and packed mask data could be sampled interchangeably.
|
||||
|
||||
## Decision
|
||||
|
||||
Material, direct-base Material Instance, and Shader Schema documents use schema v2.
|
||||
`MaterialInputSchema` is the presentation and validation contract for built-in Standard Lit,
|
||||
custom Surface evaluators, and future generated shaders. `MaterialInputSet` is the only authored
|
||||
value/texture store; instance sets remain sparse. Scalar texture bindings select R, G, B, or A,
|
||||
and scalar values multiply the sampled value. Standard Lit pairs Base Color with albedo, Metallic
|
||||
and Roughness with scalar maps, Occlusion with a scalar map, and Emissive Color/Intensity with an
|
||||
emissive map.
|
||||
|
||||
The registry uses v3 `AssetImportSettings`, with typed Model and Texture settings. Texture settings
|
||||
own semantic, color space, mip policy, compression, size limit, filtering, wrapping, anisotropy,
|
||||
and normal convention. One GPU-free processor is called by editor publication, imports, the
|
||||
watcher refresh path, and `cargo process-assets`. It writes content-addressed UASTC Basis or
|
||||
uncompressed KTX2 artifacts below `assets/.import-cache/runtime/`, records sampler/color-space data
|
||||
in runtime catalog v2, and canonicalizes authored AO/Roughness/Metallic selections to R/G/B ARM.
|
||||
Source images remain editable and unchanged. Processing computes the normalized content key before
|
||||
image decode or compression. An existing artifact at that key is reused directly, so validation and
|
||||
catalog repair do not recompress unchanged Texture or packed-Material inputs.
|
||||
|
||||
The actor inspector and asset editors consume the same schema-driven controls. A renderable owns
|
||||
one compact material-slot header; expanding it edits the resolved shared Material or Instance.
|
||||
Slot provenance and diagnostics live outside parameter rows. Valid authoring changes refresh the
|
||||
shared runtime handle immediately but only mark the asset document dirty. Explicit save uses the
|
||||
two-phase source/derived boundary from [ADR 0047](0047-editor-authored-asset-documents.md), without
|
||||
recompiling an unchanged Surface evaluator or scheduling a project-wide watcher pass.
|
||||
|
||||
This is an intentional foundation break. Normal loading accepts current documents only; explicit
|
||||
`cargo upgrade-project --project <root> --apply` converts the repository's v1/v2 documents and
|
||||
backs up every replaced file transactionally.
|
||||
|
||||
## Consequences
|
||||
|
||||
- Shader additions no longer require bespoke inspector layout code when their schema can describe
|
||||
the input.
|
||||
- Color-space and packed-channel choices are deterministic in editor, CI, and packages.
|
||||
- Cached content-addressed artifacts keep `process-assets --check` and unchanged dependency refreshes
|
||||
on the source-hash/catalog path instead of the image-compression path.
|
||||
- Runtime and Solari receive the same canonical input mapping.
|
||||
- Changing a Texture setting can invalidate dependent packed Material artifacts.
|
||||
- The future node-graph compiler must emit this schema and Surface WGSL; graph authoring itself is
|
||||
outside this decision.
|
||||
@@ -0,0 +1,71 @@
|
||||
# ADR 0047: Editor Authored-Asset Documents and Two-Phase Publication
|
||||
|
||||
## Status
|
||||
|
||||
Accepted
|
||||
|
||||
## Context
|
||||
|
||||
Material controls previously updated the viewport immediately but also wrote source when a pointer
|
||||
interaction ended. That publication could trigger file guards, Git refresh, watcher work,
|
||||
thumbnail invalidation, and whole-project processing on the editor frame thread. A slider release
|
||||
therefore behaved like an implicit save and could freeze the editor.
|
||||
|
||||
Project RON files and registry metadata are already suitable authoritative source documents. The
|
||||
editor needs a fast, durable edit boundary without adding an opaque asset database or conflating
|
||||
editor-dirty documents with source-control status.
|
||||
|
||||
## Decision
|
||||
|
||||
The editor owns an `AuthoredAssetDocumentStore` keyed by stable asset ID and document kind. It
|
||||
holds clean and current values, source path, loaded file revision, editor revision, publication
|
||||
error, recovery state, and derived-processing state for Materials, Material Instances, model import
|
||||
settings, Texture import settings, and project content defaults.
|
||||
|
||||
Interactive controls mutate the current document and `blacksite_surface`'s stable-ID-keyed
|
||||
`LiveMaterialDocumentOverlay` in the same tick. `SurfaceMaterialCache` is the sole owner of project
|
||||
Material and Material Instance handles; resolution is overlay-first and disk-second. Controls
|
||||
perform no source write, watcher refresh, Git query, thumbnail invalidation, or derived processing,
|
||||
including when the pointer is released. Dirtiness is derived from `current != clean` and remains
|
||||
distinct from Git `MODIFIED`, `UNTRACKED`, and `CONFLICT` state.
|
||||
|
||||
The cache never polls file metadata or reparses a project Material for every bound entity. Explicit
|
||||
Save and accepted watcher events invalidate the disk generation once; interactive overlay
|
||||
revisions mutate the existing cached handle in place. Imported glTF/FBX source materials stay on
|
||||
their AssetServer-owned path and do not enter the project-material resolver.
|
||||
|
||||
`Ctrl+S` saves the last edited context. `Ctrl+Shift+S` and **File > Save All** save every dirty
|
||||
scene, authored asset document, and project setting. Source publication remains guarded and atomic.
|
||||
Registry-backed documents use a clean registry baseline plus per-document overlays so saving one
|
||||
setting cannot publish another unsaved setting.
|
||||
|
||||
Successful source publication advances the clean value, then classifies its
|
||||
`DerivedProcessingImpact`. Scalar, color, emissive, shader-value, label, and render-state Material
|
||||
changes queue no derived work. ARM/ORM texture or channel changes queue material packing; Texture
|
||||
settings, model settings, and project defaults queue only their exact dependency closure. Packing
|
||||
signatures exclude scalar multipliers and are checked before image decoding so an existing
|
||||
content-addressed artifact can be reused. The previous valid runtime artifact remains authoritative until replacement
|
||||
publication succeeds; a processing failure is reported separately and does not make saved source
|
||||
dirty again. Stale job completions are ignored.
|
||||
|
||||
Dirty asset documents receive editor-local recovery snapshots after two seconds of inactivity,
|
||||
with five generations retained outside `assets/`. Startup restoration never overwrites source: a
|
||||
changed source fingerprint restores the document as an external conflict. Guarded shutdown and
|
||||
project switching count scenes, assets, and project settings in the same Save All / Discard /
|
||||
Cancel decision. Returning a document exactly to its clean value retires any older recovery
|
||||
generation on the next editor tick. Startup also discards a recovery envelope whose value already
|
||||
matches authoritative source, covering a crash between the clean edit and that cleanup tick.
|
||||
|
||||
## Consequences
|
||||
|
||||
- Parameter editing and pointer release stay frame-local and responsive.
|
||||
- Material and direct-base Instance users share one stable live handle authority instead of
|
||||
competing editor and renderer caches.
|
||||
- Saving source and generating derived artifacts are observable, independent phases.
|
||||
- The project remains plain, reviewable RON plus source assets; no asset binary database is added.
|
||||
- Unsaved editor state survives selection changes and can be recovered after a crash without
|
||||
affecting Git until the user saves.
|
||||
- Packaging and read-only processing validation must reject required pending or failed derived
|
||||
work rather than silently packaging stale content.
|
||||
- Import, extract, create, rename, move, and delete remain explicit immediate transactions because
|
||||
they create or remove project identity.
|
||||
@@ -0,0 +1,52 @@
|
||||
# ADR 0048: Modular Editor Composition and Architecture-Debt Ratchet
|
||||
|
||||
## Status
|
||||
|
||||
Accepted
|
||||
|
||||
## Context
|
||||
|
||||
The Content Browser and Inspector accumulated unrelated navigation, rendering, import, material,
|
||||
transaction, and component-card behavior in files thousands of lines long. That made small changes
|
||||
high-risk, encouraged duplicate UI, and obscured ownership. ADR 0012 states a zero-debt intent but
|
||||
did not provide an enforceable point-of-change budget.
|
||||
|
||||
## Decision
|
||||
|
||||
Editor panels are composed from thin shells, domain modules, and UI-independent services. The
|
||||
Inspector delegates every visible built-in component through `EditorComponentRegistry`; a
|
||||
hard-coded type dispatcher is not a second authority. Material slot presentation uses a shared
|
||||
view-model/action contract, and Content Browser and Material Library cards use one bounded asset
|
||||
card/status model.
|
||||
|
||||
The machine-readable policy is `.codex/architecture.toml`. Its audit enforces 500 nonblank lines
|
||||
for UI shells, 800 for other UI modules, and 1,200 for other production Rust modules. Existing
|
||||
over-limit modules have frozen ceilings. A temporary exception requires a tracker issue, rationale,
|
||||
hard maximum, extraction target, and expiry milestone. Selective verification and candidate CI run
|
||||
the audit.
|
||||
|
||||
The M2 extraction is tracked by Gitea #68. The Content Browser and Inspector shells are now below
|
||||
the 500-line budget, their domain behavior lives in bounded submodules, and no temporary #68
|
||||
exception is active. Closing the issue still requires the selective and native acceptance evidence
|
||||
defined by the milestone.
|
||||
|
||||
The Penpot-led material-inspector refinement remains inside #68's shared-UI scope. The reusable
|
||||
visual primitives live in `ui/design_system`, while `ui/materials` owns the action-returning domain
|
||||
panel. This keeps authored visual policy separate from Inspector world access and prevents the
|
||||
first design-system migration from rebuilding a panel monolith. ADR 0049 owns the visual contract.
|
||||
|
||||
## Consequences
|
||||
|
||||
- New behavior is added through a sustainable extension seam instead of enlarging a monolith.
|
||||
- Shrinking an over-limit module is always accepted; regrowth above its frozen baseline fails.
|
||||
- Passing the audit is a no-regression statement; issue closure additionally requires functional
|
||||
and native evidence for the extracted seams.
|
||||
- Architecture work remains visible in the same tracker and milestone as the feature that exposes
|
||||
it.
|
||||
- ADR 0034 owns registry-driven component semantics; this ADR owns editor composition and the
|
||||
mechanical debt guard.
|
||||
|
||||
Related decisions: [ADR 0012](0012-zero-tech-debt-editor.md),
|
||||
[ADR 0034](0034-registry-driven-authoring-components.md), and
|
||||
[ADR 0047](0047-editor-authored-asset-documents.md), and
|
||||
[ADR 0049](0049-penpot-led-editor-visual-system.md).
|
||||
@@ -0,0 +1,119 @@
|
||||
# ADR 0049: Penpot-Led Editor Visual System
|
||||
|
||||
## Status
|
||||
|
||||
Accepted
|
||||
|
||||
## Context
|
||||
|
||||
Blacksite's editor controls evolved inside individual panels. Even after the material data and
|
||||
Inspector composition became shared, local egui styling still produced inconsistent spacing,
|
||||
typography, interaction states, and narrow-panel behavior. The Penpot **Inspector Material Slot**
|
||||
provides an authored reference for the visual language rather than another implementation-specific
|
||||
mock-up.
|
||||
|
||||
## Decision
|
||||
|
||||
The Penpot **Inspector Material Slot** is the source of truth for geometry, type roles, control
|
||||
heights, radii, spacing, property-column geometry, and interaction states. Color is semantic rather
|
||||
than panel-owned: Penpot's Assets / Colors library and `editor::ui::theme::EditorVisualPalette`
|
||||
name the same roles, with Blacksite's existing palette as the default. A later Editor Settings slice
|
||||
may select or override that palette without changing widgets or material behavior. At the 620 px
|
||||
reference width, implementations match the documented geometry. Below that width, controls deliberately
|
||||
reflow instead of shrinking, clipping, scrolling horizontally, or hiding required state.
|
||||
|
||||
Fixed Penpot sections use deterministic geometry models rather than nested egui flow layouts.
|
||||
Surface, parameter rows, texture fields, UV groups, and Advanced each receive an owning rectangle;
|
||||
every child rectangle is derived from it and clipped to it. The 569 px and 369 px section widths
|
||||
encode the exported wide and compact references. A bounded transient mode below 372 px keeps all
|
||||
rectangles finite, stacks the row, and collapses low-frequency texture actions into overflow while
|
||||
the Inspector restores its 420 px minimum.
|
||||
|
||||
The reusable implementation lives under `editor::ui::design_system`. It consumes the editor-owned
|
||||
semantic palette and owns spacing tokens, Source Sans Pro Regular/Bold typography roles, section chrome, property grids,
|
||||
asset and texture fields, segmented controls, switches, status presentation, and the Blacksite
|
||||
color picker. Domain widgets consume these primitives instead of copying raw colors or absolute
|
||||
Penpot coordinates.
|
||||
|
||||
Material authoring is the first migrated domain. One action-returning `MaterialsSection` is used by
|
||||
primitive, static-mesh, and skinned-mesh inspectors. It owns an ordered list of collapsible
|
||||
`MaterialSlotPanel` models, and every returned action carries its stable slot ID. The widgets do not
|
||||
query or mutate arbitrary world state.
|
||||
Supported material behavior only is shown. Asset identity, health, inheritance, dirty state, and
|
||||
read-only state share one geometry, while stable IDs and fingerprints remain in secondary
|
||||
diagnostics.
|
||||
|
||||
The final Penpot component supersedes the earlier v2.2/v2.3 geometry. A 32 px **Materials** heading
|
||||
precedes repeated slots. Expanded slot headers are 82 px with a 64 px preview; collapsed headers
|
||||
are 52 px with a 32 px preview. A cyan disclosure spine and **PARAMETERS** ownership label inset the
|
||||
Surface, Inputs, UV, and Advanced body. The asset identity block owns the single Shader selector. Penpot's former duplicate Surface
|
||||
"Shading Model" selector was removed from the component and every state reference in handoff
|
||||
v2.3.1. Surface contains blend mode, Separate/ORM selection, and Double Sided. UV
|
||||
precedes Advanced with
|
||||
an explicit 8 px section gap. Advanced render controls
|
||||
that do not yet have renderer contracts are shown only as a clearly disabled preview: they emit no
|
||||
actions and create no authored or runtime state.
|
||||
|
||||
The Material slot header is one assignment interaction, not an identity block beside a second drop
|
||||
box. Its whole 596 x 82 px wide reference area accepts valid Material/Instance drops. Preview and
|
||||
identity clicks plus the first-class Browse action open the compact current/recent Penpot menu;
|
||||
Shader, Locate, Clear,
|
||||
and overflow actions are isolated and cannot accidentally open it. The picker returns a stable
|
||||
asset reference to the owning Inspector instead of mutating scene or world state.
|
||||
|
||||
The custom 420 x 350 color popup is a fixed modal centered over its owning Inspector clip, with an
|
||||
Inspector-local dim layer rather than application- or viewport-relative placement. Its header,
|
||||
mode tabs, wheel and values regions, RGBA byte fields, HSV degree/percentage fields, HEX copy,
|
||||
checkerboard alpha control, recents, and footer use the exported Penpot coordinates. The exported
|
||||
eyedropper lane remains a tooltip-labelled disabled preview until screen sampling has an owned
|
||||
runtime contract. Apply keeps the in-memory dirty value and closes; Cancel, Escape, Close, or
|
||||
outside dismissal restores the exact pre-open value. Neither path saves source or schedules derived
|
||||
processing.
|
||||
|
||||
Standard Lit declares seven independently stored inputs but six primary presentation rows.
|
||||
`emissive_intensity` is a schema companion of `emissive_color`; the Emissive popup previews and
|
||||
restores both values as one interaction without merging their authored/runtime identities. Custom
|
||||
shader binding counts likewise count primary rows while rendering companions through their owner.
|
||||
|
||||
Bounded scalar material inputs use one 132 px control composed from a 78 px track, 6 px gap, and
|
||||
48 x 22 numeric field. Expanding the 178 px Advanced preview requests a bounded
|
||||
Inspector scroll reveal so its note and lower boundary are visible. The same no-implicit-persistence
|
||||
rule applies to sliders, texture assignments, and shader controls.
|
||||
|
||||
Inspector overflow is part of the shared visual contract. A floating scrollbar keeps component
|
||||
width stable as content crosses the vertical overflow threshold, and every nested component clip is
|
||||
an intersection with the owning Inspector body. Ready texture fields use the typed thumbnail as
|
||||
their sole leading identity; generic image glyphs are reserved for empty states.
|
||||
|
||||
Standard Lit exposes one shared UV Offset/Tiling transform through the same schema-driven input
|
||||
document. The renderer maps it to Bevy StandardMaterial UV transforms and to every Surface ABI
|
||||
texture lane. Material Instances may override it sparsely; resetting an instance restores its base.
|
||||
|
||||
Penpot's `CODEGEN MAP` and handoff annotations are design documentation. Runtime egui layout remains
|
||||
responsive and semantic; generated SVG or code is not copied into production. Reviewed numeric
|
||||
geometry is represented by small testable layout models instead of ad hoc child flow or generated
|
||||
widget trees.
|
||||
The same release slice applies the active Inspector Header, Array Header, renderer-panel, asset
|
||||
field, vector, selection, and overlay components across the Inspector. Built-in component cards
|
||||
dispatch through the registry and share one clipped actor-body scroll owner; domain behavior stays
|
||||
outside the visual primitives.
|
||||
|
||||
## Consequences
|
||||
|
||||
- New editor UI has one reviewed visual vocabulary rather than panel-local approximations.
|
||||
- Theme colors have one runtime owner and one design-side asset vocabulary; the material panel does
|
||||
not carry a private blue/teal palette.
|
||||
- The 620 px and 420 px geometries are deterministic and unit-testable. The Inspector has a 420 px
|
||||
floor and one actor-body scroll region; material slots never introduce nested scrolling.
|
||||
- Unsupported prototype controls are omitted until their runtime contracts exist.
|
||||
- The explicitly approved Advanced preview is the sole exception: it is disabled, muted, and
|
||||
labelled as planned work rather than functioning authoring state.
|
||||
- Native acceptance compares rendered geometry, typography, states, and interaction behavior with
|
||||
the Penpot reference; compile-only evidence is insufficient.
|
||||
- Source Sans Pro and its SIL Open Font License are bundled with the editor.
|
||||
- ADR 0048 continues to own composition and module-size policy. This ADR owns visual tokens,
|
||||
responsive component geometry, and interaction presentation.
|
||||
|
||||
Related decisions: [ADR 0035](0035-shared-material-assets-and-renderer-slots.md),
|
||||
[ADR 0047](0047-editor-authored-asset-documents.md), and
|
||||
[ADR 0048](0048-modular-editor-composition-and-debt-ratchet.md).
|
||||
@@ -0,0 +1,9 @@
|
||||
# Documentation Archive
|
||||
|
||||
This directory preserves documents that retain provenance or evidentiary value but no longer belong
|
||||
in a live topic tree. Archived documents are historical, not current guidance, and must retain an
|
||||
obvious historical banner linking the relevant canonical document.
|
||||
|
||||
Moving a record here does not change architecture or product behavior. Classify it in
|
||||
`docs/authority.toml`, preserve useful dates and commit references, and update the live index rather
|
||||
than copying its detailed contract into multiple places.
|
||||
@@ -0,0 +1,307 @@
|
||||
version = 1
|
||||
classifications = ["current", "active-plan", "evidence", "historical", "superseded"]
|
||||
roles = ["overview", "canonical", "architecture", "active-plan", "evidence", "historical", "superseded"]
|
||||
|
||||
[discovery]
|
||||
paths = ["README.md"]
|
||||
trees = ["docs", ".cursor/plans"]
|
||||
|
||||
# Rules are deterministic: the highest priority matching rule wins. Equal-priority
|
||||
# matches must agree. Repository-root paths are used throughout.
|
||||
|
||||
[[rules]]
|
||||
id = "root-readme"
|
||||
path = "README.md"
|
||||
classification = "current"
|
||||
role = "overview"
|
||||
topics = ["project-overview", "user-workflow"]
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "documentation-default"
|
||||
prefix = "docs/"
|
||||
classification = "current"
|
||||
role = "canonical"
|
||||
priority = 10
|
||||
|
||||
[[rules]]
|
||||
id = "accepted-adrs"
|
||||
prefix = "docs/adr/"
|
||||
classification = "current"
|
||||
role = "architecture"
|
||||
priority = 20
|
||||
|
||||
[[rules]]
|
||||
id = "superseded-render-timeout-adr"
|
||||
path = "docs/adr/0019-local-bevy-render-timeout-patch.md"
|
||||
classification = "superseded"
|
||||
role = "superseded"
|
||||
replacement = "docs/adr/0022-bevy-0-19-upgrade.md"
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "superseded-component-spec"
|
||||
path = "docs/editor/Bevy_Editor_Component_System_Spec.md"
|
||||
classification = "superseded"
|
||||
role = "superseded"
|
||||
replacement = "docs/adr/0034-registry-driven-authoring-components.md"
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "historical-release-notes"
|
||||
path = "docs/editor/release-notes.md"
|
||||
classification = "historical"
|
||||
role = "historical"
|
||||
replacement = "docs/README.md"
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "active-editor-debt-gate"
|
||||
path = "docs/editor/debt-audit.md"
|
||||
classification = "active-plan"
|
||||
role = "active-plan"
|
||||
topics = ["editor-debt", "production-readiness"]
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "evaluation-records"
|
||||
prefix = "docs/editor/evaluations/"
|
||||
classification = "evidence"
|
||||
role = "evidence"
|
||||
replacement = "docs/README.md"
|
||||
priority = 30
|
||||
|
||||
[[rules]]
|
||||
id = "evaluation-index"
|
||||
path = "docs/editor/evaluations/README.md"
|
||||
classification = "current"
|
||||
role = "overview"
|
||||
topics = ["acceptance-evidence"]
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "historical-h1"
|
||||
path = "docs/editor/evaluations/h1-signoff.md"
|
||||
classification = "historical"
|
||||
role = "historical"
|
||||
replacement = "docs/editor/evaluations/production-readiness/README.md"
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "historical-h2"
|
||||
path = "docs/editor/evaluations/h2-signoff.md"
|
||||
classification = "historical"
|
||||
role = "historical"
|
||||
replacement = "docs/editor/evaluations/production-readiness/README.md"
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "historical-h3"
|
||||
path = "docs/editor/evaluations/h3-signoff.md"
|
||||
classification = "historical"
|
||||
role = "historical"
|
||||
replacement = "docs/editor/evaluations/production-readiness/README.md"
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "historical-h4"
|
||||
path = "docs/editor/evaluations/h4-signoff.md"
|
||||
classification = "historical"
|
||||
role = "historical"
|
||||
replacement = "docs/editor/evaluations/production-readiness/README.md"
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "historical-h5"
|
||||
path = "docs/editor/evaluations/h5-signoff.md"
|
||||
classification = "historical"
|
||||
role = "historical"
|
||||
replacement = "docs/editor/evaluations/production-readiness/README.md"
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "historical-h6"
|
||||
path = "docs/editor/evaluations/h6-signoff.md"
|
||||
classification = "historical"
|
||||
role = "historical"
|
||||
replacement = "docs/editor/evaluations/production-readiness/README.md"
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "archive-records"
|
||||
prefix = "docs/archive/"
|
||||
classification = "historical"
|
||||
role = "historical"
|
||||
replacement = "docs/README.md"
|
||||
priority = 30
|
||||
|
||||
[[rules]]
|
||||
id = "archive-index"
|
||||
path = "docs/archive/README.md"
|
||||
classification = "current"
|
||||
role = "overview"
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "plans-default"
|
||||
prefix = ".cursor/plans/"
|
||||
classification = "historical"
|
||||
role = "historical"
|
||||
replacement = "docs/README.md"
|
||||
priority = 10
|
||||
|
||||
[[rules]]
|
||||
id = "superseded-project-roadmap"
|
||||
path = ".cursor/plans/project_roadmap_8a452d43.plan.md"
|
||||
classification = "superseded"
|
||||
role = "superseded"
|
||||
replacement = "docs/README.md"
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "active-production-program"
|
||||
path = ".cursor/plans/blacksite_production_readiness_2026-07-10.plan.md"
|
||||
classification = "active-plan"
|
||||
role = "active-plan"
|
||||
topics = ["production-readiness"]
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "active-production-gate"
|
||||
path = ".cursor/plans/production_readiness_acceptance_2026-07-12.plan.md"
|
||||
classification = "active-plan"
|
||||
role = "active-plan"
|
||||
topics = ["production-readiness"]
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "active-content-workspace"
|
||||
path = ".cursor/plans/content_workspace_and_import_authoring_2026-07-13.plan.md"
|
||||
classification = "active-plan"
|
||||
role = "active-plan"
|
||||
topics = ["content-workspace", "asset-import", "content-browser", "materials"]
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "canonical-content-workspace"
|
||||
path = "docs/editor/content-workspace.md"
|
||||
classification = "current"
|
||||
role = "canonical"
|
||||
topics = ["content-workspace", "asset-import", "content-browser"]
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "canonical-material-system"
|
||||
path = "docs/editor/material-system.md"
|
||||
classification = "current"
|
||||
role = "canonical"
|
||||
topics = ["materials", "material-slots", "default-grid", "texture-processing"]
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "workflow-overview"
|
||||
path = "docs/workflow/codex-workflow.md"
|
||||
classification = "current"
|
||||
role = "overview"
|
||||
topics = ["codex-workflow"]
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "canonical-documentation-policy"
|
||||
path = "docs/workflow/documentation-policy.md"
|
||||
classification = "current"
|
||||
role = "canonical"
|
||||
topics = ["documentation-authority"]
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "canonical-verification-policy"
|
||||
path = "docs/workflow/verification-policy.md"
|
||||
classification = "current"
|
||||
role = "canonical"
|
||||
topics = ["selective-verification"]
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "canonical-build-storage-policy"
|
||||
path = "docs/workflow/build-storage-policy.md"
|
||||
classification = "current"
|
||||
role = "canonical"
|
||||
topics = ["build-storage"]
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "canonical-gitea-policy"
|
||||
path = "docs/workflow/gitea-tracking-policy.md"
|
||||
classification = "current"
|
||||
role = "canonical"
|
||||
topics = ["gitea-tracking"]
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "content-workspace-architecture"
|
||||
path = "docs/adr/0045-content-workspace-and-material-fallback-contract.md"
|
||||
classification = "current"
|
||||
role = "architecture"
|
||||
topics = ["content-workspace", "materials", "default-grid"]
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "material-input-architecture"
|
||||
path = "docs/adr/0046-schema-driven-material-inputs-and-processed-textures.md"
|
||||
classification = "current"
|
||||
role = "architecture"
|
||||
topics = ["materials", "texture-processing"]
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "authored-asset-document-architecture"
|
||||
path = "docs/adr/0047-editor-authored-asset-documents.md"
|
||||
classification = "current"
|
||||
role = "architecture"
|
||||
topics = ["content-workspace", "materials", "recovery", "collaboration"]
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "penpot-editor-visual-architecture"
|
||||
path = "docs/adr/0049-penpot-led-editor-visual-system.md"
|
||||
classification = "current"
|
||||
role = "architecture"
|
||||
topics = ["editor-design-system", "materials", "responsive-ui"]
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "canonical-editor-design-system"
|
||||
path = "docs/editor/design-system.md"
|
||||
classification = "current"
|
||||
role = "canonical"
|
||||
topics = ["editor-design-system", "responsive-ui"]
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "m2-content-evidence"
|
||||
path = "docs/editor/evaluations/content-workspace-m2/README.md"
|
||||
classification = "evidence"
|
||||
role = "evidence"
|
||||
topics = ["content-workspace", "content-browser"]
|
||||
replacement = "docs/README.md"
|
||||
priority = 100
|
||||
|
||||
[[rules]]
|
||||
id = "production-readiness-evidence"
|
||||
path = "docs/editor/evaluations/production-readiness/README.md"
|
||||
classification = "evidence"
|
||||
role = "evidence"
|
||||
topics = ["production-readiness"]
|
||||
replacement = "docs/README.md"
|
||||
priority = 100
|
||||
|
||||
[[stale_terms]]
|
||||
pattern = "registry v2"
|
||||
replacement = "registry v3 or explicit migration wording"
|
||||
allowed_paths = ["docs/editor/evaluations/**", "docs/archive/**"]
|
||||
|
||||
[[stale_terms]]
|
||||
pattern = "Authoring Material"
|
||||
replacement = "material slot"
|
||||
allowed_paths = ["README.md", "docs/adr/**", "docs/archive/**", "docs/editor/evaluations/**"]
|
||||
@@ -1,5 +1,7 @@
|
||||
# Tech Spec: Unity-style Component List for a Bevy Level Editor
|
||||
|
||||
> **Superseded specification — not current implementation guidance.** Component ownership is defined by [ADR 0034](../adr/0034-registry-driven-authoring-components.md); material-slot ownership is defined by [ADR 0035](../adr/0035-shared-material-assets-and-renderer-slots.md).
|
||||
|
||||
## Purpose
|
||||
|
||||
The component list is the main authoring UI for a selected **Actor** in the level. In this editor, an **Actor** is a Bevy `Entity` plus editor-facing metadata: stable ID, display name, hierarchy position, prefab/link info, and a curated list of inspectable components.
|
||||
|
||||
@@ -1,13 +1,15 @@
|
||||
# Editor Framework Documentation
|
||||
|
||||
Docs for the in-process egui editor (`crates/editor/`). Update this index when adding editor subsystems.
|
||||
Consult [`docs/authority.toml`](../authority.toml) before using a page as current guidance. Evaluation
|
||||
records below are dated evidence, not product specifications.
|
||||
|
||||
## Documents
|
||||
|
||||
| Document | Contents |
|
||||
|----------|----------|
|
||||
| [roadmap.md](roadmap.md) | Phased editor work and status |
|
||||
| [architecture.md](architecture.md) | Plugins, cameras, PIE, settings split |
|
||||
| [architecture.md](architecture.md) | Plugins, cameras, PIE, settings split, and modular panel composition |
|
||||
| [brp.md](brp.md) | Remote protocol, authoring-only policy, commands |
|
||||
| [debt-audit.md](debt-audit.md) | Zero-debt phase gates and remaining items |
|
||||
| [rendering.md](rendering.md) | GI modes, post-process volumes, presets, post FX assets |
|
||||
@@ -22,14 +24,16 @@ Docs for the in-process egui editor (`crates/editor/`). Update this index when a
|
||||
| [animation-authoring.md](animation-authoring.md) | glTF rig/clip import, stable controller states, preview, runtime API, and validation |
|
||||
| [navigation-authoring.md](navigation-authoring.md) | Bounds, source geometry, deterministic bake, viewport path preview, and runtime query workflow |
|
||||
| [extensibility.md](extensibility.md) | Static authoring component lifecycle registration, stable IDs, composition, and generic history |
|
||||
| [material-system.md](material-system.md) | Shared Material/Material Instance assets, static/skinned renderer slots, Surface ABI, Solari scope, and migration |
|
||||
| [design-system.md](design-system.md) | Penpot-led tokens, typography, responsive property grids, material controls, and picker behavior |
|
||||
| [material-system.md](material-system.md) | Unified primitive/static/skinned slots, schema-driven inputs, processed textures, Surface ABI, and migration |
|
||||
| [content-workspace.md](content-workspace.md) | File-manager content organization, destination-first import, stable identity, and model material mapping |
|
||||
| [collaborative-file-safety.md](collaborative-file-safety.md) | Exact authored-file revisions, Git/read-only status, conflict recovery, and optional ownership providers |
|
||||
| [native-dialogs.md](native-dialogs.md) | Non-blocking file/folder/confirmation acquisition and main-thread result application |
|
||||
| [terrain.md](terrain.md) | Inline height-grid terrain, chunk hydration, collision, inspector workflow, and fixtures |
|
||||
| [physics-placement.md](physics-placement.md) | Transactional gravity placement, prerequisites, isolation, commit/cancel, and undo |
|
||||
| [collider-authoring.md](collider-authoring.md) | Collider shape editing, shared health diagnostics, overlays, hydration status, and placement reuse |
|
||||
| [sample-regression-pack.md](sample-regression-pack.md) | Five-area sample manifest, native workflow, visual composition, validation, and maintenance contract |
|
||||
| [evaluations/](evaluations/) | Acceptance evidence records and native Gitea attachment publishing policy |
|
||||
| [evaluations/](evaluations/) | Dated acceptance evidence and native Gitea attachment publishing policy; not current behavior guidance |
|
||||
| [evaluations/material-renderer-foundation/](evaluations/material-renderer-foundation/) | Live screenshots and verification record for the renderer/material/component foundation |
|
||||
| [evaluations/material-library-targeted-drop/](evaluations/material-library-targeted-drop/) | Live screenshot and verification record for the docked Material Library and exact reversible surface drops |
|
||||
| [evaluations/collaborative-file-safety/](evaluations/collaborative-file-safety/) | Live screenshot and verification record for source-control status and guarded external-change recovery |
|
||||
@@ -46,6 +50,7 @@ Docs for the in-process egui editor (`crates/editor/`). Update this index when a
|
||||
| [evaluations/scoped-ui-actions/](evaluations/scoped-ui-actions/) | Exact-implementation source and native acceptance evidence for actions invoked during scoped egui rendering |
|
||||
| [evaluations/deterministic-asset-fingerprints/](evaluations/deterministic-asset-fingerprints/) | Source, fresh-checkout, hash-stability, and native acceptance evidence for imported-source fingerprints |
|
||||
| [evaluations/fbx-external-texture-dependencies/](evaluations/fbx-external-texture-dependencies/) | Source, validation, and native acceptance evidence for sandboxed FBX sidecar dependencies and override states |
|
||||
| [evaluations/content-workspace-m2/](evaluations/content-workspace-m2/) | Native M2 evidence for file-manager selection, item/empty-space context menus, managed-folder visibility, and resizable Content Browser Details |
|
||||
| [evaluations/production-readiness/](evaluations/production-readiness/) | Current #50 release-candidate matrix and required clean-checkout, soak, performance, limitation, and independent-signoff evidence |
|
||||
|
||||
## Subsystems (code → doc)
|
||||
@@ -63,10 +68,10 @@ Docs for the in-process egui editor (`crates/editor/`). Update this index when a
|
||||
| `play/audio_preview.rs` / `game::audio` | Non-dirty editor audition and authored runtime playback/bus adapter | audio-authoring.md, ADR 0030 |
|
||||
| `assets/animation.rs` / `ui/animation_inspector.rs` / `game::animation` | Generated animation manifests, controller authoring/preview, and runtime state adapter | animation-authoring.md, ADR 0031 |
|
||||
| `ui/navigation_inspector.rs` / `scene::navigation` / `game::navigation` | Navigation authoring, deterministic bake artifacts, viewport preview, and runtime path queries | navigation-authoring.md, ADR 0032 |
|
||||
| `assets/materials.rs` / `ui/material_library.rs` / `viewport/material_drop.rs` / `shared::renderer_material` | Shared material discovery, docked catalog/usage UI, exact reversible surface drops, stable renderer slots, and draw binding | material-system.md, ADR 0035 |
|
||||
| `ui/design_system/` / `ui/materials/` / `ui/asset_card.rs` / `assets/materials.rs` / `viewport/material_drop.rs` / `shared::renderer_material` | Penpot-led editor primitives, shared material view models, bounded asset-card status, unified slot authoring, exact reversible surface drops, and draw binding | design-system.md, material-system.md, ADR 0035, ADR 0046, ADR 0048, ADR 0049 |
|
||||
| `blacksite_surface` / `game_hot::rendering::solari` / `third_party/bevy_solari` | Surface ABI packing, raster composition, Solari evaluator dispatch, and deformation eligibility | material-system.md, rendering.md, ADR 0036 |
|
||||
| `assets/fingerprint.rs` / `shared::AssetSourceFingerprint` | Content-addressed imported-source identity and byte-preserving registry/manifest publication | ADR 0043, evaluations/deterministic-asset-fingerprints/ |
|
||||
| `assets/` | Catalog, transactional import bundles, asset DB, static mesh artifacts, `thumbnails/`, `materials.rs`, prefab overrides v2 | this file (below), prefab-authoring.md, ADR 0017, ADR 0027, ADR 0044 |
|
||||
| `assets/` / `content_pipeline` | Catalog, typed model/Texture import settings, deterministic runtime artifacts, transactional imports, thumbnails, and prefab overrides | this file (below), content-workspace.md, ADR 0017, ADR 0027, ADR 0044, ADR 0046 |
|
||||
| `shared::prefab_overrides` | Versioned stable override schema and editor-independent runtime application | prefab-authoring.md, ADR 0027 |
|
||||
| `project/` | Workspace, settings UI, user prefs, support diagnostics | roadmap Phase 1 |
|
||||
| `project/collaboration.rs` | Guarded authored writes, asynchronous Git status, and optional ownership providers | collaborative-file-safety.md, ADR 0037 |
|
||||
@@ -93,7 +98,7 @@ Docs for the in-process egui editor (`crates/editor/`). Update this index when a
|
||||
- **Dedicated egui `Camera2d`** at full window — never attach `PrimaryEguiContext` to a viewport-cropped 3D camera (NaN layout panic).
|
||||
- **Unified viewport** uses one render-to-texture target for both the editor fly camera and the possessed player camera so HDR/atmosphere is not broken by sub-viewport cropping.
|
||||
- **PIE:** F8 possess/eject while sim runs; **F6** pauses/resumes simulation in Play; project settings drive shared rendering for the active viewport camera.
|
||||
- **Asset browser** mirrors the on-disk `assets/` directory with project tree, breadcrumb, search/filter/sort, grid/list views, texture/model/material thumbnails, a details pane, and context-aware row/menu actions; narrow docks prioritize content, keep the root panel fixed, switch list view to a compact single-column layout, and hide tree/details panes when they would crowd the content area. The footer stays pinned while only the project tree, asset content, and details panels scroll. **Built-ins** holds spawnable primitives and lights. **Materials** folder scans `assets/materials/*.ron`, renders material thumbnails on a sphere using `MaterialDesc`, and exposes shader-schema-driven parameters/textures in the details editor; **Shaders** holds shader schema RON files. **Audio** accepts Bevy-supported Ogg/Vorbis and Speex (`.ogg`, `.oga`, `.spx`), WAV, MP3, and FLAC clips under `assets/audio/`, with a dedicated filter, waveform icon, format/file details, and stable registry-backed references that retain a runtime source path. glTF/GLB/FBX rows can expand into a shelf of normalized embedded mesh, material, and texture subassets with independent generated thumbnails. Mesh subassets can be selected, dragged into the viewport, or placed from details/context menus; material subassets render source-material spheres; texture subassets can be applied to the selected actor. Model import settings are staged with **Apply** / **Revert**, asset context menus can regenerate thumbnails, material asset details edit shared `MaterialAsset` fields, and file asset deletion moves sources/generated artifacts into `assets/.trash/`. Before thumbnail loading, glTF sources preflight local external buffers/images. FBX source-material previews use the same sandboxed resolver as import and validation, expose one cached hover-visible dependency failure, and never enqueue known-missing texture paths; neutral model/mesh previews remain available. Asset details mark present/missing dependencies and identify missing textures intentionally ignored by Authoring Override. FBX bundle import preserves referenced sibling or `.fbm/` layout transactionally. See [ADR 0044](../adr/0044-sandboxed-fbx-external-texture-dependencies.md).
|
||||
- **Asset browser** mirrors the on-disk `assets/` directory with project tree, breadcrumb, search/filter/sort, grid/list views, texture/model/material thumbnails, a details pane, and context-aware row/menu actions. It uses file-manager selection semantics across files and folders (click, Ctrl/Cmd toggle, Shift range, Ctrl/Cmd+A), batch clipboard/duplicate/trash/drag operations, keyboard shortcuts, and empty-space workspace menus. The details divider is draggable so asset and import settings can use more horizontal space, and double-clicking it restores the default width. Narrow docks prioritize content, keep the root panel fixed, switch list view to a compact single-column layout, and hide tree/details panes when they would crowd the content area. The footer stays pinned while only the project tree, asset content, and details panels scroll. **Built-ins** holds spawnable primitives and lights. Materials and shaders are classified by document schema anywhere under `assets/`; the browser renders material thumbnails on a sphere and exposes shader-schema-driven parameters/textures in Details. **Audio** accepts Bevy-supported Ogg/Vorbis and Speex (`.ogg`, `.oga`, `.spx`), WAV, MP3, and FLAC clips, with a dedicated filter, waveform icon, format/file details, and stable registry-backed references. glTF/GLB/FBX rows expand into normalized embedded mesh, material, and texture subassets. Model and Texture Details edit asset-keyed **UNSAVED** documents; `Ctrl+S` saves the active context and `Ctrl+Shift+S` saves all before affected-only background processing. FBX previews use the same sandboxed dependency resolver as import and validation; missing textures are required when any slot uses Source and informational when every slot uses Project/Default. Bundle import preserves referenced sibling or `.fbm/` layout transactionally. See [content-workspace.md](content-workspace.md) and [ADR 0044](../adr/0044-sandboxed-fbx-external-texture-dependencies.md).
|
||||
- **Imported-source fingerprints** use exact byte length plus lowercase BLAKE3 for model, texture, and audio registry records and for generated static-mesh/animation manifests. Filesystem timestamps are scan hints only; equivalent refresh preserves the exact committed RON bytes and registry publication order is normalized by project path. See [ADR 0043](../adr/0043-content-addressed-import-fingerprints.md) and the [acceptance record](evaluations/deterministic-asset-fingerprints/).
|
||||
- **Material Library** is a dockable bottom-panel catalog for cross-folder Material and direct-base Material Instance authoring. It provides search, type and scene-usage filters, grid/list thumbnails, dependency health, usage counts, creation, guarded details editing, and first-class drag sources. Viewport drops resolve an exact renderer slot, primitive, or brush face under the pointer, preview transiently, reject incompatible/read-only targets explicitly, restore on target change/cancel, and commit one typed undo step on release.
|
||||
- **Static/skinned renderer split** — model drag/drop uses normalized artifacts under `assets/meshes/generated/`. Unrigged, non-animated sources create `ActorKind::StaticMesh + StaticMeshRenderer`; skin-bound or animated sources create `ActorKind::SkinnedMesh + SkinnedMeshRenderer` and preserve the imported hierarchy. Static slots never contain marked skinned primitives or geometry from animated sources. `SceneInstance` placement keeps `ImportedModel + ModelRef` for generic full-source scenes. See [ADR 0033](../adr/0033-dedicated-skinned-mesh-renderer.md).
|
||||
@@ -103,7 +108,7 @@ Docs for the in-process egui editor (`crates/editor/`). Update this index when a
|
||||
- **Draw Brush** — `B`, toolbar pencil, or command `brush.draw` enters a floor-polygon draw mode. LMB places snapped points, Backspace removes the last point, Enter locks the outline for height editing, mouse up/down adjusts height, and Enter/LMB creates additive prism brushes through history. Esc/right-click cancels. Simple concave outlines decompose into convex brush parts; self-intersections remain blocked.
|
||||
- **Brush edit modes** — with a brush selected, `1`/`2`/`3`/`4` enter vertex, edge, face, and clip element modes. Element modes show brush handles in the viewport, own LMB picking, support Shift multi-select, show a mode badge, and Esc returns to object mode. Vertex/edge/face selections use the standard `W`/`E`/`R` gizmo at the element pivot and commit undoable `SetBrush` edits. Clip previews a bounds-based half-brush and commits with Enter; command-palette intersect, convex merge, and subtract operations use the same preview/commit lifecycle for conservative cuboid/prism blockout.
|
||||
- **Collider split and health** — imported mesh collision lives in a separate `ColliderDesc::StaticMesh` plus optional `RigidBodyDesc`; renderer slots own only render visibility, shadows, mesh, and material references. Inspector, viewport, Diagnostics, and physics placement share one authored/runtime health result; see [collider-authoring.md](collider-authoring.md).
|
||||
- **Material assets and renderer slots** — Material and direct-base Material Instance documents are shared assets. `StaticMeshRenderer` and `SkinnedMeshRenderer` each own stable material slots with imported source defaults and explicit shared assignments; Clear returns to the source default, while reimported missing slots retain overrides as orphans instead of matching by name. The property-block schema is runtime-only and persistence-excluded, while renderer application/promotion remains #53. Custom Surface evaluators use the same constrained ABI for raster and Solari-eligible non-deformed geometry; skinned/morph geometry is deliberately excluded from Solari until #54 adds deformed BLAS updates. See [material-system.md](material-system.md), [ADR 0035](../adr/0035-shared-material-assets-and-renderer-slots.md), and [ADR 0036](../adr/0036-surface-abi-and-solari-parity.md).
|
||||
- **Material assets and renderer slots** — Material and direct-base Material Instance documents are shared assets. `StaticMeshRenderer` and `SkinnedMeshRenderer` each own stable material slots with scene, model, source, project-default, and DefaultGrid resolution. Reimported missing project mappings remain visible orphans. Runtime-only property blocks clone and cache the resolved Standard or Surface base per owner/slot, leaving invalid overrides non-destructive. Custom Surface evaluators use the same constrained ABI for raster and Solari-eligible non-deformed geometry; skinned/morph geometry is deliberately excluded from Solari until #54 adds deformed BLAS updates. See [material-system.md](material-system.md), [content-workspace.md](content-workspace.md), [ADR 0035](../adr/0035-shared-material-assets-and-renderer-slots.md), and [ADR 0036](../adr/0036-surface-abi-and-solari-parity.md).
|
||||
- **Prefab authoring** — shared `PrefabOverrides` targets generated actors by nested anchor chain plus stable `ActorId`, and applies reflected property/component plus same-layer structural operations in editor and game hydration. The editor supports scoped Revert and transactional **Apply to source** with three-way conflict checks, exact-file undo guards, and recoverable changed/broken/conflict states. `HydratedPrefabMember` keeps generated content out of owner serialization; linked-root saves retain local structure as variants. **Unpack Layer** preserves nested links, while **Convert to Local** recursively removes them. See [prefab-authoring.md](prefab-authoring.md) and [ADR 0027](../adr/0027-stable-prefab-ownership-and-variants.md).
|
||||
- **Visual language** uses a near-black industrial shell, a compact Blacksite identity mark, restrained amber actions/primary selection, cyan secondary selection, semantic status colors, stable grouped controls, and shared elevated viewport chips. Primary/secondary selection roles remain consistent across hierarchy rows, viewport x-ray shells/corner brackets, the selection HUD, and transform interactions. See [visual-language.md](visual-language.md).
|
||||
- **Hierarchy** shows authored objects plus useful runtime context (`Player`, `PlayerCamera`, Project Sun). Ordinary runtime rows remain read-only; generated prefab rows expose override-aware inspection and same-layer remove/reparent actions while rejecting cross-instance/layer and composition-boundary drops. Locks prevent selection, gizmos, drag participation, structural targets, and mutating context actions. Authored reparenting preserves world placement and records parent/local-transform/manual-order changes as one undoable command.
|
||||
|
||||
@@ -129,7 +129,12 @@ Three camera roles coexist:
|
||||
|
||||
**WYSIWYG rendering:** `render_view.rs` is the only editor system that mutates viewport post-FX. It calls `game_hot::sync_viewport_camera_stack` on the active camera (editor fly or possessed player), driven by `ActiveCameraRenderProfile` from project settings and volumes plus `EffectiveRenderStack` for requested/effective GI fallback. `scene_view` and `play/session` set HDR render targets and `is_active` only—they do not strip FX. Only one camera carries the stack at a time (mesh-view bind group limits). See [ADR 0015](../adr/0015-viewport-camera-stack-ownership.md) and [ADR 0016](../adr/0016-unified-rendering-contract.md).
|
||||
|
||||
The viewport uses **render-to-texture**: the active camera renders to an offscreen HDR target sized to the dock panel (`panel_physical_size()`), then egui displays that texture. Cameras use `viewport = None` on image targets so the scissor always matches the texture; panel size only drives texture allocation, not a sub-viewport on the image.
|
||||
The viewport uses **render-to-texture**: the active camera renders to an offscreen HDR target sized
|
||||
to the dock panel (`panel_physical_size()`), then egui displays that texture. Cameras use
|
||||
`viewport = None` on image targets so the scissor always matches the texture; panel size only drives
|
||||
the image extent, not a sub-viewport on the image. Resizing mutates the existing Image asset so its
|
||||
ID and Egui texture registration remain stable. The presentation layer owns at most one strong Egui
|
||||
registration and removes it when the target is replaced or absent.
|
||||
|
||||
**HDR invariant:** Atmosphere, authored HDR, and effective Solari all require an `Hdr`
|
||||
camera target; they must never render to the primary window swapchain
|
||||
@@ -220,12 +225,15 @@ the Edit-to-Play boundary restore the complete runtime snapshot. See
|
||||
|
||||
## Model import (glTF + FBX)
|
||||
|
||||
- **Import:** File -> Import Assets copies glTF/GLB/FBX into `assets/models/`. An FBX import
|
||||
- **Import:** **Import Here** and **Import To...** copy glTF/GLB/FBX into the chosen normal folder
|
||||
beneath `assets/` without type-directory routing. An FBX import
|
||||
parses every safe external texture reference, including sibling `textures/` and `.fbm/` layouts,
|
||||
then stages and publishes the complete referenced bundle transactionally. Absolute non-sidecar
|
||||
paths, parent traversal, and dependencies that canonically escape the source folder are rejected
|
||||
before project files change; unreferenced sidecar contents are not copied.
|
||||
- **Processing:** the asset registry generates normalized model manifests under
|
||||
- **Processing:** `content_pipeline` owns one scan/reconciliation path used by editor startup,
|
||||
manual refresh, the debounced watcher, validation, packaging, and the headless command. Browser
|
||||
selection changes never trigger registry scans. The processor generates normalized model manifests under
|
||||
`assets/meshes/generated/`. The manifests store stable part IDs, glTF/FBX mesh/material subasset
|
||||
labels, whether each part is skin-bound, source metadata, dependencies, and import settings.
|
||||
Model, texture, and audio registry records use byte length plus BLAKE3 source identity; model
|
||||
@@ -236,8 +244,8 @@ the Edit-to-Play boundary restore the complete runtime snapshot. See
|
||||
- **FBX dependencies:** the local `bevy_ufbx` resolver owns separator normalization, safe `.fbm/`
|
||||
rebasing, deduplication, and sandbox rejection. Static-mesh manifests record every declared
|
||||
external texture even when it is absent. Project validation reports one blocking finding for
|
||||
missing Source Materials textures, or one informational finding when Authoring Override
|
||||
deliberately leaves the model untextured. The runtime loader reads unique dependencies through
|
||||
missing textures used by any per-slot Source selection, or one informational finding when every
|
||||
slot deliberately uses Project/Default. The runtime loader reads unique dependencies through
|
||||
`LoadContext` and creates labeled images directly, so missing paths cannot fan out into repeated
|
||||
asset-server errors. See [ADR 0044](../adr/0044-sandboxed-fbx-external-texture-dependencies.md).
|
||||
- **Browser subassets:** model rows can expand into a content shelf backed by the generated
|
||||
@@ -300,6 +308,26 @@ PIE stop restores player simulation state only; authored `LevelObject` edits mad
|
||||
| `history/` | Undo commands + plugin |
|
||||
| `ui/` | egui dock shell |
|
||||
|
||||
### Panel composition and debt budgets
|
||||
|
||||
`ui/inspector.rs` and `ui/asset_browser/panel.rs` are thin composition shells and are not homes for
|
||||
new domain behavior. Inspector component cards register callbacks through
|
||||
`EditorComponentRegistry`; the registry is the only visible built-in dispatcher. Shared Material
|
||||
presentation lives under `ui/materials/`, while bounded thumbnail/footer/status presentation lives
|
||||
in `ui/asset_card.rs`. Content transactions, material resolution, authored-document publication,
|
||||
and derived-processing decisions remain outside egui rendering.
|
||||
|
||||
The actor Inspector owns one fixed identity header and one actor-keyed component scroll region.
|
||||
Its scrollbar is floating with stable width reservation, so vertical overflow never changes the
|
||||
width supplied to responsive component cards. Nested component UIs intersect their local bounds
|
||||
with the inherited clip and must not expand painting or input above the fixed actor header.
|
||||
|
||||
The enforceable budgets and frozen legacy ceilings live in `.codex/architecture.toml`;
|
||||
`scripts/codex/architecture_audit.py` runs in selective verification and candidate CI. Both UI
|
||||
shells satisfy the 500-nonblank-line limit. Any future exception requires a tracker, rationale,
|
||||
maximum, extraction target, and expiry milestone.
|
||||
See [ADR 0048](../adr/0048-modular-editor-composition-and-debt-ratchet.md).
|
||||
|
||||
Shared scene schema lives in the Bevy-free `crates/scene` crate (stamp/migrate/validate on save,
|
||||
load, and CI). `game::schema_world_loader` is the runtime adapter that validates and unwraps the
|
||||
schema envelope before Bevy deserializes versioned prefab assets; both game and editor install it
|
||||
@@ -307,7 +335,21 @@ through `GamePlugin`.
|
||||
|
||||
## HDR / swapchain invariant
|
||||
|
||||
The unified viewport renders through an HDR offscreen target (`render_target.rs`). When the panel target is missing (egui reflow), cameras must strip atmosphere/post-FX before targeting the swapchain. User-authored HDR may be disabled, but atmosphere and effective Solari still force `Hdr` on the active viewport camera because Bevy sky/Solari pipelines are not safe to carry across SDR targets. `render_view::sync_project_render_view` runs in **PostUpdate** after RTT target assignment and reapplies the project FX stack whenever the active panel target handle changes (startup, resize), not only on settings Apply. Project Settings uses a **draft buffer**; **Apply** commits after render targets resync.
|
||||
The unified viewport renders through an HDR offscreen target (`render_target.rs`). When the panel
|
||||
target is missing (egui reflow), cameras must strip atmosphere/post-FX before targeting the
|
||||
swapchain. User-authored HDR may be disabled, but atmosphere and effective Solari still force `Hdr`
|
||||
on the active viewport camera because Bevy sky/Solari pipelines are not safe to carry across SDR
|
||||
targets. `render_view::sync_project_render_view` runs in **PostUpdate** after RTT target assignment
|
||||
and reapplies the project FX stack whenever the active panel target handle changes (startup or
|
||||
exceptional replacement), not only on settings Apply. Ordinary resize preserves the handle and
|
||||
updates the Image asset in place. Project Settings uses a **draft buffer**; **Apply** commits after
|
||||
render targets resync.
|
||||
|
||||
The editor host and packaged game intentionally use different presentation priorities. The editor
|
||||
uses `AutoNoVsync`, preferring Immediate or Mailbox where supported, because FIFO acquisition on
|
||||
NVIDIA Wayland can block for about one second per frame throughout an interactive native-window
|
||||
resize. Packaged game windows retain `AutoVsync`. This complements the stable offscreen-target
|
||||
ownership rule; it does not replace it.
|
||||
|
||||
Bevy 0.19 removed the workspace's prior local `bevy_render` swapchain-timeout patch. The only active Bevy-adjacent patches are compatibility shims for ecosystem crates: `transform-gizmo-bevy` and `bevy_ufbx` under `third_party/`.
|
||||
|
||||
|
||||
@@ -19,23 +19,32 @@ Default HTTP endpoint follows Bevy 0.19 remote defaults (port **15702**, routes
|
||||
|
||||
## Authoring-only mutation policy
|
||||
|
||||
**BRP and automation must mutate authoring components only** — the same allowlist used on scene save in `scene_io.rs`. Hydration rebuilds runtime ECS (`Mesh3d`, Bevy lights, physics, `WorldAssetRoot`, etc.) on the next frame.
|
||||
**BRP and durable automation must mutate authoring components only** — the same allowlist used on
|
||||
scene save in `scene_io.rs`. Hydration rebuilds runtime ECS (`Mesh3d`, Bevy lights, physics,
|
||||
`WorldAssetRoot`, etc.) on the next frame. One deliberate editor-only exception exists for
|
||||
`MaterialPropertyBlocks`: trusted local tooling may inject this explicitly runtime-only component
|
||||
to preview or promote a transient override. It is still excluded from scene/prefab persistence and
|
||||
the Add Component registry.
|
||||
|
||||
| Allowed (examples) | Forbidden on level objects |
|
||||
|--------------------|----------------------------|
|
||||
| `Transform`, `Name`, `ActorKind` | `PointLight`, `SpotLight`, `DirectionalLight` |
|
||||
| `Primitive`, `StaticMeshRenderer`, `SkinnedMeshRenderer`, `MaterialDesc`, `MaterialOverride`, `LightDesc` | `Mesh3d`, `MeshMaterial3d`, `RigidBody`, `Collider` |
|
||||
| `Primitive`, `StaticMeshRenderer`, `SkinnedMeshRenderer`, brush-only legacy `MaterialDesc`, `LightDesc` | `Mesh3d`, `MeshMaterial3d`, `RigidBody`, `Collider` |
|
||||
| `ModelRef`, `RigidBodyDesc`, `ColliderDesc`, legacy `PhysicsBody`, gameplay markers | `WorldAssetRoot`, generated static/skinned roots, internal visibility types |
|
||||
| `PostProcessVolumeDesc` | Runtime post-process components on cameras |
|
||||
|
||||
`shared::renderer_material::MaterialPropertyBlocks` is a runtime diagnostic/tooling exception, not
|
||||
a durable authoring component. Use **Promote to Material Instance** in the exact Inspector slot when
|
||||
the variation should become project content.
|
||||
|
||||
Prefer:
|
||||
|
||||
1. Editing `LightDesc` instead of `SpotLight` / `DirectionalLight`
|
||||
2. Editing `MaterialDesc` instead of `StandardMaterial` handles
|
||||
2. Editing the owning `Primitive.surface` or renderer `MaterialSlotSet` instead of `StandardMaterial` handles; `MaterialDesc` is limited to the brush/legacy fallback path
|
||||
3. Editing `StaticMeshRenderer` instead of child `Mesh3d` entities
|
||||
4. Editing `SkinnedMeshRenderer` instead of its hydrated joint/mesh hierarchy
|
||||
5. Editing `ColliderDesc` / `RigidBodyDesc` instead of runtime Avian components
|
||||
5. Version-controlled `assets/levels/*.scn.ron` for durable changes
|
||||
6. Version-controlled `assets/levels/*.scn.ron` for durable changes
|
||||
|
||||
See [ADR 0009 — Authoring vs hydrated](../adr/0009-authoring-vs-hydrated.md).
|
||||
|
||||
|
||||
@@ -0,0 +1,200 @@
|
||||
# Content Workspace
|
||||
|
||||
Blacksite treats the project `assets/` tree as a user-organized content workspace. Folders are for
|
||||
organization and do not determine asset type. The stable asset registry ID is authoritative; a path
|
||||
is mutable metadata that moves, validation, and packaging repair through the shared content catalog.
|
||||
|
||||
## Content boundaries
|
||||
|
||||
- User assets may live in any normal nested folder beneath `assets/`.
|
||||
- External absolute linked assets are unsupported so projects remain portable and packageable.
|
||||
- `.index`, `.trash`, thumbnails, recovery data, and derived artifacts are hidden and protected.
|
||||
- Authored document schemas and typed registry records identify RON assets. Ambiguous or invalid
|
||||
documents report diagnostics instead of being guessed from their folder.
|
||||
|
||||
## Content Browser workflow
|
||||
|
||||
The Content Browser toolbar provides **New Folder**, **Rename**, **Duplicate**, **Cut**, **Copy**,
|
||||
and **Paste**. The selected folder is the destination for paste and **File > Import Assets**. These
|
||||
operations use the shared content transaction engine: it previews collisions, rejects managed or
|
||||
symlink paths, stages filesystem and cached-reference changes together, preserves IDs on moves,
|
||||
assigns new IDs to copies, and rolls back on failure. Successful move, rename, create-folder, copy,
|
||||
duplicate, and authored-file creation transactions add a content-specific **Undo Content** entry.
|
||||
Move/rename undo applies the inverse reference-safe transaction. Undoing newly created content
|
||||
moves the unchanged result into transactional Trash, so it remains restorable instead of being
|
||||
permanently deleted. Every undo is blocked if any affected file or folder has changed externally
|
||||
since commit. Registry and stripped runtime-catalog publication are part of the same rollback
|
||||
boundary.
|
||||
|
||||
Before create-folder, rename, move, copy, duplicate, paste, or drag-to-folder commits, **Review
|
||||
Content Operation** lists every source/destination, affected registered-asset count, and each cached
|
||||
RON document whose path hint will be rewritten. Collisions are shown in the same window and disable
|
||||
commit. Read-only files, provider locks, and source-control conflicts are visible and block commit;
|
||||
modified/untracked state remains visible but does not. Source and rewrite-document fingerprints are
|
||||
captured for the review, so any external edit before confirmation also blocks the stale transaction.
|
||||
Cancel restores the pre-review folder, selection, anchor, status, clipboard, and drag state; a
|
||||
cancelled drag review clears only the stale drag gesture. Folder-scoped **Paste Into** and
|
||||
**Import To** pin their destinations without navigating the browser.
|
||||
|
||||
Delete remains trash-first. **Trash** in the toolbar, **Open Trash** in a folder/empty-space context
|
||||
menu, and the restore window expose complete deletion batches. A new batch records the original
|
||||
paths and registry records before moving bytes under `assets/.trash/`. Model batches also carry
|
||||
their generated static/animation manifests so deletion or guarded undo cannot leave orphan runtime
|
||||
artifacts; restoring the batch restores those exact derived bytes with the source. Restore preserves
|
||||
stable IDs and is blocked if a destination path, derived path, or registry ID is now occupied.
|
||||
Legacy trash batches are shown when their original paths can be inferred, but have no historical
|
||||
registry IDs to recover. A normal Move to Trash action also records the exact batch in Content Undo,
|
||||
so Ctrl/Cmd+Z restores it when the batch fingerprint and destinations remain valid.
|
||||
Before confirmation, the trash review enumerates external authored RON documents, model mappings,
|
||||
project-default selection, and dependency records that will become unresolved; references inside
|
||||
the same selected tree are excluded from that warning.
|
||||
|
||||
Selection follows desktop file-manager conventions in both grid and list views: click selects one,
|
||||
Ctrl/Cmd-click toggles an item, Shift-click selects the visible range from the anchor, and
|
||||
Ctrl/Cmd+A selects every visible result. Folders are first-class selectable and draggable items;
|
||||
double-click opens them and clears the previous folder's selection so hidden content cannot be
|
||||
changed accidentally. Starting a drag on an unselected item selects that item first, while dragging
|
||||
one member of an existing multi-selection preserves the complete batch. Batch Cut, Copy, Duplicate,
|
||||
drag-to-folder, and Move to Trash operate on the complete selection while removing nested duplicates
|
||||
such as a selected folder and one of its children; the menu reports those children as covered by
|
||||
the parent rather than mislabeling them as ignored. Changing search text, recursive scope, or the
|
||||
kind filter clears the selection so a now-hidden item cannot receive a keyboard operation. Sorting
|
||||
and switching grid/list view preserve selection because they do not hide results. Content shortcuts only take ownership while the
|
||||
pointer is over the content pane: Ctrl/Cmd+C, X, V, D, A and Z, Ctrl/Cmd+Shift+N, F2, and Delete.
|
||||
Ctrl/Cmd+Z invokes the most recent guarded Content Browser operation; it does not consume scene
|
||||
history while the pointer is outside the content pane. The browser surface and its shortcuts are
|
||||
disabled while any Content Browser review/modal or popup menu is open, so a confirmation click or
|
||||
keystroke cannot also mutate the selection behind it. Cut/Paste keeps the exact requested basename; an occupied destination is
|
||||
shown as a collision in **Review Content Operation** instead of being silently renamed.
|
||||
Embedded mesh, material, texture, skeleton, and animation rows are authoring subassets rather than
|
||||
filesystem entries; generic rename/clipboard/drag-to-folder/trash commands never reinterpret one as
|
||||
its parent model file.
|
||||
|
||||
Right-clicking an unselected file, folder, or embedded model subasset makes it the primary selection
|
||||
before opening its menu. Right-clicking one member of an existing multi-selection preserves the
|
||||
complete batch. File menus expose type-specific actions plus Rename, Cut, Copy, Duplicate, and Move
|
||||
to Trash. Folder menus add destination-scoped import, paste, and creation actions. Right-clicking
|
||||
unused content space clears any old selection and opens workspace actions for **Import Here**,
|
||||
**Import To**, **Create Material Here**, **Create Materials From Folder**, **New Folder**, **Paste**,
|
||||
**Select All**, **Refresh**, and grid/list view selection. New Materials are authored directly in the
|
||||
current folder; the Material Library's create button retains `assets/materials/` as its convenient
|
||||
default.
|
||||
Double-clicking a scene opens it, a model toggles its embedded contents, and other asset types reveal
|
||||
their editable Details. The footer and Details pane summarize multi-selections; single-selection
|
||||
Details remains the authoritative editor for import and material settings. Drag the Details divider
|
||||
to resize it for long slot/shader forms; double-click the divider to restore its default width.
|
||||
Texture Details uses the same pane for semantic/color-space intent, mip generation, UASTC or
|
||||
uncompressed KTX2 output, resize limits, sampler settings, and normal-Y conversion. Changes become
|
||||
an **UNSAVED** Texture document immediately; explicit Save publishes the settings and queues
|
||||
affected-only derived processing without rewriting the editable source image.
|
||||
|
||||
Thumbnail cache keys are typed by asset category. Texture cards may use direct image loads, while
|
||||
model cards always queue the offscreen geometry studio—even when a glTF has a base-color texture.
|
||||
Expanded mesh rows request their exact mesh-subasset render, and source materials use a separate
|
||||
material-sphere key. Missing dependencies produce an explicit failed thumbnail; a model or mesh
|
||||
card never substitutes an albedo texture. Replacing, retrying, or invalidating a thumbnail also
|
||||
unregisters its last Egui image handle, so repeated catalog refreshes release the prior GPU image
|
||||
instead of accumulating hidden render targets.
|
||||
|
||||
**Import Here** pins the current/selected folder before the native picker opens. **Import To...**
|
||||
first opens a project-folder chooser without navigating away from the current browser location.
|
||||
After files are chosen, a second review lists every source dependency and exact final project path;
|
||||
collisions disable commit and cancel publishes nothing. Source/dependency fingerprints and target
|
||||
absence are checked again at commit so external changes after review cannot overwrite project data.
|
||||
|
||||
External FBX and textual glTF imports preserve relative texture/buffer layouts as one staged bundle.
|
||||
The complete multi-source picker batch is preflighted before mutation: existing targets and two
|
||||
sources mapping to one target are reported as collisions, and any publication failure removes all
|
||||
new files and directories from that batch. Missing dependencies, traversal, and symlink escapes
|
||||
also fail before the destination changes. GLB is self-contained. Files already under `assets/` are
|
||||
shown as **Adopt in place** in the review and processed without copying or type-folder sorting.
|
||||
|
||||
Folder/file Move preserves registry IDs and rewrites cached paths in project documents, model
|
||||
defaults, the runtime catalog, and generated manifests. Copy/Duplicate assigns new IDs, remaps only
|
||||
references internal to the copied tree, and leaves the originals plus external references
|
||||
untouched. Copied models discard inherited generated-manifest paths so normal processing publishes
|
||||
fresh artifacts under the copied model ID.
|
||||
Out-of-editor moves reconcile imported assets only when one missing record has the matching kind
|
||||
and source fingerprint. If the watcher finds one new file matching multiple missing records, it
|
||||
opens **Resolve Ambiguous External Moves** and leaves registry/manifests unchanged. Each row must
|
||||
either preserve exactly one candidate ID or intentionally **Register as New Asset**; one old ID
|
||||
cannot be assigned to two new paths. **Review Later** leaves a **Resolve Moves** toolbar action, and
|
||||
Apply rechecks the registry, files, and candidate set before publishing. Headless processing fails
|
||||
with the same candidate paths until the choice is completed in the editor; neither path silently
|
||||
replaces stable identity.
|
||||
|
||||
Imported static and skinned model Details expose stable material slots. Each slot selects its source
|
||||
material, a project Material/Instance, or **Default**; bulk Source and Default actions are
|
||||
available. Default intentionally skips the imported source and resolves through the project
|
||||
fallback, then immutable DefaultGrid. Reimport reconciles by stable slot ID and retains removed project assignments as explicit
|
||||
orphans. The displayed source health makes a missing imported material distinct from an intentional
|
||||
Default selection. **Locate** reveals the referenced project Material/Instance, while **Clear**
|
||||
returns an active model slot to Source. Orphan rows provide **Locate** and **Clear Orphan** so a
|
||||
removed source slot can be reviewed and resolved explicitly before applying the import settings.
|
||||
|
||||
The former whole-model Source Materials/Authoring Override switch is migration input only. Explicit
|
||||
processing expands legacy Authoring Override into a Default selection for each stable slot, resets
|
||||
the legacy field, and publishes only per-slot selections to current registry/manifests. Validation
|
||||
requires an FBX texture bundle while any slot uses Source; an all-Project/Default model keeps missing
|
||||
source textures visible as informational provenance instead of a release blocker.
|
||||
|
||||
For glTF, GLB, and FBX, **Extract Editable Materials Here** opens a conversion review containing
|
||||
every source material, converted metallic/roughness and render state, detected external texture
|
||||
channels, and the editable final project paths. Embedded texture payloads remain source-owned; the
|
||||
review still converts supported scalar PBR values. Confirmed entries become normal
|
||||
`*.material.ron` assets and every model draw slot using that source material is changed to a
|
||||
`Project(...)` selection in the same rollback-capable content transaction. The generated model
|
||||
manifest is refreshed immediately so editor and packaged runtime bindings agree. A first
|
||||
extraction uses a collision-free path. On a later extraction into the same folder, matching source
|
||||
path and stable source-slot provenance opens an explicit diff: choose **Apply Reviewed Update** to
|
||||
replace the edited Material, or **Create New Copy** to preserve it as a separate revision. Apply is
|
||||
guarded by the reviewed file fingerprint, participates in transaction rollback, and is blocked if
|
||||
the file changes before publication; mismatched provenance can never overwrite an unrelated
|
||||
Material. Each extracted Material records read-only source path, stable source-slot identity, and
|
||||
source-content fingerprint provenance in Details.
|
||||
|
||||
For loose texture sets, right-click their folder or unused space inside it and choose **Create
|
||||
Materials From Folder**. The review window detects common PBR suffixes such as `albedo`,
|
||||
`basecolor`, `diff`, `normal`, `nor_gl`, `roughness`, `metallic`, `ao`, `orm`/`arm`, `height`, and
|
||||
`displacement`. Every row shows its confidence and stays editable. Change a row's **Target** to
|
||||
merge it into another material or split it into a new material; change **Role** to correct a guess.
|
||||
Unresolved images remain visible and start unchecked. Creation publishes every selected group as
|
||||
one atomic content transaction and chooses a suffixed filename instead of overwriting an existing
|
||||
Material. Packed ORM/ARM maps use R=occlusion, G=roughness, and B=metallic.
|
||||
|
||||
Project Settings > Content selects an optional project fallback Material/Instance. Clear restores
|
||||
the immutable **Default Grid — Engine Built-in**. DefaultGrid is world-space and UV-independent, so
|
||||
broken or unassigned meshes stay visible.
|
||||
|
||||
Material, Material Instance, model-import, Texture-import, and project-default edits live in an
|
||||
editor-owned authored-document store until explicitly saved. **UNSAVED** is editor state and is
|
||||
shown separately from Git state. `Ctrl+S` saves the last edited context; `Ctrl+Shift+S` and
|
||||
**File > Save All** save every dirty scene, asset document, and project setting. Selection changes
|
||||
never discard a dirty asset. Source publication is guarded and atomic, then affected-only derived
|
||||
processing runs in the background while the previous valid artifact remains active.
|
||||
Material scalar/color/render-state saves do not show `PROCESSING`; only packed-map binding changes
|
||||
do. Content Browser and Material Library cards share clipped two-line labels, a top-right grid-card
|
||||
status rail, and fixed-width list markers, so state never paints over or shifts an asset name.
|
||||
|
||||
## Headless processing
|
||||
|
||||
Run `cargo process-assets --project <root>` to deterministically refresh registry v3, normalized
|
||||
static/animation model manifests, processed Texture artifacts, canonical Material ARM maps, and
|
||||
`assets/content.catalog.ron` without a GPU. All planned artifacts and both catalogs publish under
|
||||
one rollback boundary. Use `--check` in CI for a strictly read-only comparison that fails on any
|
||||
stale artifact, and `--json` for machine-readable diagnostics. Texture and packed-Material keys are
|
||||
resolved before image decode; an existing content-addressed artifact is reused, so an unchanged
|
||||
check validates source hashes and catalog references without recompressing images.
|
||||
Editor startup, the toolbar/empty-space **Refresh** action, and the shared watcher all use the same
|
||||
processor. Saved authored documents enqueue revisioned, coalesced jobs rather than running the
|
||||
whole processor on the UI frame. The watcher debounces and deduplicates user-content paths, ignores
|
||||
managed/generated publication noise, incrementally rescans the same registry/catalog model,
|
||||
refreshes selection-safe browser state, and invalidates thumbnail caches. Selection-only UI changes
|
||||
never fingerprint or republish content. Editor transactions suppress their filesystem events until commit. Failures remain visible
|
||||
in the editor status line. When an external deletion leaves authored references unresolved, the
|
||||
status includes their count and affected document paths. Thumbnail rendering remains editor-owned.
|
||||
Ambiguous move repair is rediscovered on startup and manual refresh, so choosing **Review Later**
|
||||
cannot lose the repair entry across an editor restart.
|
||||
|
||||
The permanent storage, material precedence, and fallback decisions are in
|
||||
[ADR 0045](../adr/0045-content-workspace-and-material-fallback-contract.md).
|
||||
@@ -1,5 +1,7 @@
|
||||
# Editor zero-debt audit checklist
|
||||
|
||||
> **Active plan — describes incomplete release/debt gate work.** Current shipped behavior is indexed in the [canonical documentation](../README.md).
|
||||
|
||||
Living checklist for the production editor program ([ADR 0012](../adr/0012-zero-tech-debt-editor.md)). Update when closing a phase or removing debt.
|
||||
|
||||
## Must not ship (gate before phase sign-off)
|
||||
@@ -17,6 +19,10 @@ Living checklist for the production editor program ([ADR 0012](../adr/0012-zero-
|
||||
| Checkout metadata or filesystem enumeration can rewrite imported-asset artifacts | Done | Shared content fingerprints, semantic byte-preserving publication, normalized registry order, clean-checkout validators, and live mtime-only drift pass at `cbd380a`; see the [evaluation](evaluations/deterministic-asset-fingerprints/). |
|
||||
| Dual FBX thumbnail ad-hoc path (parallel to unified pipeline) | Partial | Phase 5 `assets/thumbnails/` refactor |
|
||||
| `failed_keys` thumbnail cache without retry API | Partial | `asset_thumbnails.rs`; Phase 5 `ThumbnailState` |
|
||||
| Inspector hard-coded component dispatcher | Done | `EditorComponentRegistry` is the sole visible built-in dispatcher; startup rejects missing callbacks |
|
||||
| `ui/inspector.rs` monolith | Done — P0 #68 | 363 nonblank-line registry-dispatch shell; component cards and complex domains are separate modules |
|
||||
| `ui/asset_browser/panel.rs` monolith | Done — P0 #68 | 450 nonblank-line shell; navigation, cards, Details, import, extraction, transactions, trash, and undo are separate modules |
|
||||
| Architecture debt can grow silently | Done | `.codex/architecture.toml` plus `scripts/codex/architecture_audit.py`; exact frozen baselines ratchet every remaining legacy module |
|
||||
|
||||
## Phase completion gates
|
||||
|
||||
|
||||
@@ -0,0 +1,153 @@
|
||||
# Editor Design System
|
||||
|
||||
Blacksite's editor uses the Penpot **Inspector Material Slot** as its visual source of truth. This
|
||||
guide defines the reusable visual and interaction language; domain behavior remains in its owning
|
||||
editor subsystem. See [ADR 0049](../adr/0049-penpot-led-editor-visual-system.md).
|
||||
|
||||
## Semantic palette
|
||||
|
||||
The default theme mirrors Blacksite's established palette. These values are published under
|
||||
Penpot Assets / Colors and represented by `EditorVisualPalette`; domain widgets consume semantic
|
||||
roles rather than literals. Theme selection and persistence are intentionally deferred to Editor
|
||||
Settings, but the renderer-facing UI seam already accepts a different palette.
|
||||
|
||||
| Role | Default |
|
||||
|------|-------|
|
||||
| Canvas / panel / recessed | `#07080A` / `#0D0F12` / `#090B0D` |
|
||||
| Control / elevated | `#15181C` / `#1F2328` |
|
||||
| Brand accent / hover | `#E5A433` / `#F9C14F` |
|
||||
| Selection and valid drop | `#41C6CF` |
|
||||
| Border / strong border | `#262B31` / `#40474F` |
|
||||
| Primary / secondary / muted text | `#DCE1E5` / `#9BA3AB` / `#606972` |
|
||||
| Healthy / warning / error | `#54BE7F` / `#EBB448` / `#E25E5E` |
|
||||
|
||||
Source Sans Pro Regular and Bold are bundled in `crates/editor/assets/fonts/source-sans/`. Type
|
||||
roles use the Penpot 9–16 px scale; weight is selected through separate egui font families rather
|
||||
than simulated styling. Spacing follows 4/8/12 px steps. Common controls are 22–31 px tall with
|
||||
4/5/6/7/8 px radii.
|
||||
|
||||
Use semantic tokens from `ui/design_system`; do not copy literal colors into a domain card. The
|
||||
selection color is reserved for focus, valid drag targets, selection, and active values. Health,
|
||||
unsaved, processing, failed, read-only, inherited, and built-in states keep the same geometry.
|
||||
|
||||
## Composition contract
|
||||
|
||||
Reusable controls render a supplied view model and return actions. They do not query unrelated
|
||||
Bevy resources, save files, schedule processing, or directly mutate scene/world state. The owning
|
||||
domain resolves actions after rendering. This keeps the visual system reusable in the Inspector,
|
||||
Content Browser, Material Library, and future editor panels.
|
||||
|
||||
The material implementation is split as follows:
|
||||
|
||||
- `ui/design_system` owns tokens, typography, control chrome, property-grid geometry, and the color
|
||||
popup.
|
||||
- `ui/materials/panel.rs` owns the material-slot view model and action contract, while
|
||||
`ui/materials/pickers.rs` owns the compact current/recent Material menu and the richer Texture
|
||||
asset-picker presentation.
|
||||
- `ui/materials/inputs.rs` renders schema-declared material controls.
|
||||
- Inspector and asset editors provide state and apply returned actions through authored documents.
|
||||
|
||||
## Reference layout
|
||||
|
||||
At the current 620 px wide reference, 12 px outer padding produces a 596 px slot and a 569 px parameter
|
||||
body. A 32 px **Materials** heading precedes repeated slots. Expanded headers are 82 px with a
|
||||
64 px preview; collapsed headers are 52 px with a 32 px preview. Surface is 46 px, Inputs is
|
||||
216 px (24 px header plus six 32 px rows), UV is 54 px, and Advanced is 30 px collapsed or 178 px
|
||||
expanded. An expanded wide row keeps its label/value/channel geometry fixed while only the texture
|
||||
field grows above the reference width.
|
||||
|
||||
| Column | Width |
|
||||
|--------|-------|
|
||||
| Parameter label | 82 px |
|
||||
| Value | 132 px |
|
||||
| Value/channel gap | 6 px |
|
||||
| Channel | 48 px |
|
||||
| Channel/texture gap | 16.5 px |
|
||||
| Texture field | 198.5 px at the reference width |
|
||||
| Locate / Clear | 24 px each, separated by 6 px |
|
||||
|
||||
At the 420 px Inspector floor, the slot is 396 px and parameter sections are 369 px. Surface remains
|
||||
46 px and Inputs is 372 px: each of the six rows uses a 58 px two-line layout with parameter,
|
||||
value, and channel above a 345 px asset picker. UV reflows from 54 px to 94 px. The layout must not introduce nested or horizontal
|
||||
scrolling, clipped buttons, or height-dependent width changes.
|
||||
|
||||
These reference dimensions are implemented as owning rectangles, not nested `horizontal` flow.
|
||||
At 569 px, each input row begins its value at x96, channel at x234, and texture group at x298.5.
|
||||
At 369 px, the parameter line is `x12/y5/w345` and the texture line is
|
||||
`x12/y31/w345`. Texture names are clipped and ellipsized inside the field, so content cannot move
|
||||
the fixed Locate/Clear anchors. A transient width below 372 px retains finite clipped rectangles
|
||||
and replaces the two low-frequency texture actions with one overflow control until the Inspector
|
||||
minimum is restored.
|
||||
|
||||
## Material controls
|
||||
|
||||
Primitive, static-mesh, and skinned-mesh surfaces use the same ordered `MaterialsSection` and
|
||||
slot-keyed `MaterialSlotPanel` actions. Static/skinned geometry cards do not embed duplicate
|
||||
material presentations. The slot header and
|
||||
asset zone include the material sphere, bounded name and project-relative path, shader, health,
|
||||
assignment interaction, and responsive actions. The entire zone is the drop target; there is no
|
||||
second “Drop material asset” box. Preview/name/path and Browse open the picker, while Shader,
|
||||
Locate, Clear, and overflow remain isolated. Direct assignments do not show an “Explicit” badge.
|
||||
Inherited identities are limited to Model Source, Model Default, Project Default, and Default Grid.
|
||||
|
||||
Expanded content shows supported controls only:
|
||||
|
||||
- Surface: Opaque/Cutout, cutoff when Cutout, Separate/ORM, and Double Sided.
|
||||
- Inputs: six Standard Lit rows. Emissive color owns the independently stored intensity companion
|
||||
and edits/restores both through the Emissive popup.
|
||||
- UV: two equal Offset/Tiling groups with fixed X/Y controls and independent resets; Material
|
||||
Instances reset to inheritance.
|
||||
- Advanced Inputs: only evaluator-supported schema declarations.
|
||||
|
||||
Imported source content is read-only with Extract Editable in overflow. DefaultGrid is immutable.
|
||||
Broken explicit references keep their failed identity and diagnostics rather than exposing a weaker
|
||||
layer. Stable IDs, fingerprints, orphan state, and provenance live in overflow diagnostics, not in
|
||||
the parameter grid.
|
||||
|
||||
## Pickers and direct manipulation
|
||||
|
||||
The compact Material menu shows the current assignment and editor-local recent choices, then offers
|
||||
Browse Asset Library and Clear. The richer Texture picker uses bounded thumbnail rows for current,
|
||||
recent, and project textures. A popup dismissal or invalid choice does not assign anything. Material and
|
||||
Instance drops use the active theme's selection highlight; Texture drops show an explicit invalid state.
|
||||
|
||||
Handoff v2.3.1 has one Shader selector in the asset identity block. Surface contains the blend mode
|
||||
and Double Sided without a visible `Blend` label; it does not mirror Shader as a second "Shading
|
||||
Model" control. UV is followed by a
|
||||
collapsed Advanced row. Its culling, render queue, depth-write, and receive-shadows mock controls are
|
||||
explicitly painted muted previews until those renderer contracts exist, and therefore never return
|
||||
actions. Standard egui disabled opacity is not compounded over these controls.
|
||||
|
||||
The Inspector actor identity remains fixed. The remaining dock-tab body is one actor-salted
|
||||
component scroll region whose clip is intersected with the dock body, so scrolled Transform or
|
||||
component cards cannot paint or receive input beneath the actor header. Component-local children
|
||||
must preserve that inherited clip rather than replacing it with their own maximum rectangle. The
|
||||
vertical scrollbar floats over a stable four-pixel interaction rail, so crossing the height overflow
|
||||
threshold cannot change the content width or trigger a responsive-layout flip.
|
||||
|
||||
Texture fields open their picker when the field itself is clicked. They show a thumbnail or typed
|
||||
fallback icon plus Locate and Clear actions. A ready typed thumbnail replaces the generic Texture
|
||||
glyph rather than appearing beside a redundant icon; a redundant folder button is not used.
|
||||
|
||||
The color popup is a fixed 420 x 350 px modal centered over the owning Inspector region, with a
|
||||
dimmed Inspector-local scrim. Its exported geometry includes a 38 px header, 250 x 26 mode tabs,
|
||||
178 x 202 wheel editor, 198 x 186 values region, byte RGBA fields, degree/percentage HSV fields,
|
||||
functional HEX copy, a 156 x 14 checkerboard alpha control, 396 x 28 recents row, and 396 x 26
|
||||
footer. Wheel, Sliders, and Presets share that fixed frame. The exported eyedropper lane is a muted,
|
||||
non-interactive preview labelled `Planned — screen sampling pending`.
|
||||
|
||||
Every preview updates the live material document. Apply keeps the dirty in-memory value; Cancel,
|
||||
Escape, Close, and outside dismissal restore the exact value captured on open. No picker action
|
||||
writes source or queues derived processing. Material scalar inputs use the reusable 130 x 22
|
||||
Penpot control: a 70 x 14 track, 10 px thumb, 8 px separation, and 48 x 22 numeric field. Expanding
|
||||
Advanced scrolls its complete 178 px disabled-preview body into view rather than revealing a clipped
|
||||
partial section.
|
||||
|
||||
## Review checklist
|
||||
|
||||
- Verify the 620 px geometry numerically and in a native capture.
|
||||
- Verify the narrow reflow, long and Unicode names, invalid drops, read-only/imported/built-in
|
||||
states, and popup cancellation.
|
||||
- Verify handle identity and dirty-document behavior during live interaction.
|
||||
- Run `python scripts/codex/architecture_audit.py check`; new design-system work does not earn an
|
||||
exception from the module-size ratchet.
|
||||
@@ -1,8 +1,11 @@
|
||||
# Editor Evaluation Evidence
|
||||
|
||||
Each subdirectory keeps the canonical, versioned acceptance record for an editor feature. Record
|
||||
visual evidence with its attachment ID, dimensions, and checksum. A repository image copy is
|
||||
optional; the committed Markdown record, not a raw image URL, is the source of truth.
|
||||
Each subdirectory keeps dated acceptance evidence for an editor feature. Evidence records describe
|
||||
what was observed against a named implementation; they are not current product specifications.
|
||||
Resolve current behavior through [`docs/authority.toml`](../../authority.toml) and the linked
|
||||
canonical guide or ADR. Record visual evidence with its attachment ID, dimensions, and checksum. A
|
||||
repository image copy is optional; the committed Markdown record, not a raw image URL, is the
|
||||
durable evidence source.
|
||||
|
||||
## Publishing To Gitea
|
||||
|
||||
@@ -15,3 +18,9 @@ attachment so the evidence remains traceable to its tested source and exact comm
|
||||
Native attachments are the presentation copies used by issues and pull requests. Do not commit a
|
||||
duplicate image solely to publish it; retain verification notes and attachment metadata in the
|
||||
evaluation record.
|
||||
|
||||
## Records
|
||||
|
||||
The [editor documentation index](../README.md) lists feature evidence records. The
|
||||
[production-readiness matrix](production-readiness/) is the active candidate-evidence ledger;
|
||||
H1–H6 sign-offs are historical snapshots.
|
||||
@@ -1,5 +1,7 @@
|
||||
# Collaborative File Safety Evaluation
|
||||
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../README.md) for current behavior and architecture.
|
||||
|
||||
Date: 2026-07-12
|
||||
Branch: `codex/collaboration-live-acceptance`
|
||||
Implementation commits: `5a82a9e`, `f2ad88f`
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Collider Diagnostics Acceptance
|
||||
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../README.md) for current behavior and architecture.
|
||||
|
||||
Issue: Gitea #26 (`BS-JD-305`)
|
||||
|
||||
## Evidence
|
||||
|
||||
@@ -0,0 +1,205 @@
|
||||
# M2 Content Workspace Native Evaluation
|
||||
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../README.md) for current behavior and architecture.
|
||||
|
||||
**Date:** 2026-07-14
|
||||
|
||||
**Milestone:** [M2 - Content workspace and asset pipeline](https://git.spacetrainclubhouse.com/Falling-Metal-Interactive/Blacksite/milestone/12)
|
||||
|
||||
**Epic:** [Gitea #59](https://git.spacetrainclubhouse.com/Falling-Metal-Interactive/Blacksite/issues/59)
|
||||
|
||||
**Base commit:** `931f561e7ff1489f897e22ebb3cc7545fcfef702`
|
||||
|
||||
**Implementation revision:** Candidate tree passed all gates; exact commit assigned at publication
|
||||
|
||||
**Release-candidate commit:** Pending publication commit
|
||||
|
||||
**Native interaction acceptance:** **Pass for the workflows recorded below**
|
||||
|
||||
**Pinned Penpot acceptance targets:** [export index](penpot/README.md)
|
||||
|
||||
This feature-level record covers the Content Browser interaction pass added during M2 completion.
|
||||
It does not close the milestone or replace the exact-commit, clean-checkout, import/reimport,
|
||||
forward/Solari, packaging, and independent signoff gates in the M2 plan.
|
||||
|
||||
## Native Protocol
|
||||
|
||||
The normal debug editor was rebuilt with `cargo build -p editor --bin editor`, launched as
|
||||
`LD_LIBRARY_PATH=target/debug/deps target/debug/editor --project .`, and exercised in native
|
||||
Wayland windows at 3426x1384 and 1440x3440. The project stayed live throughout each workflow and
|
||||
was stopped without saving the temporary placement scene.
|
||||
|
||||
| Workflow | Result | Evidence |
|
||||
|----------|--------|----------|
|
||||
| Managed storage visibility | Pass | `assets/.index`, `.trash`, `.thumbnails`, `.import-cache`, and generated artifact directories were absent from the tree and content grid; ordinary content folders remained visible. |
|
||||
| Empty workspace context | Pass | Right-clicking visible unused content space cleared the selected model and opened Import Here, PBR grouping, Create Material Here, New Folder, Open Trash, Paste, Undo, Select All, Refresh, and view actions. |
|
||||
| Multi-selection | Pass | Ctrl-click selected `assets/build_profiles` and `assets/levels` together; both tiles, the two-item footer, and the multi-selection Details summary stayed synchronized. |
|
||||
| Batch context menu | Pass | Right-clicking one selected folder preserved both selections and exposed Cut, Copy, Duplicate, and Move Selection To Trash. |
|
||||
| Item context menu | Pass | Right-clicking the Poly Haven desk model selected it and exposed model actions plus Rename, Cut, Copy, Duplicate, and Move To Trash. |
|
||||
| Details resizing | Pass | Dragging the Content Browser divider expanded the Details pane; its hover affordance described drag resize and double-click reset. |
|
||||
| Background/item priority | Pass | The workspace background menu remained available without intercepting folder/model clicks or Ctrl multi-selection. |
|
||||
| Destination-first bundled import | Pass | Created `assets/Props/Office/` through reviewed folder transactions, chose **Import Here** from genuinely empty space, and imported the Poly Haven `metal_office_desk_2k.gltf` directly there with its `.bin` and three relative textures. No type-specific routing occurred. |
|
||||
| Import To and final-path review | Pass | Chose `assets/Furniture/Office` without navigating away from the root browser view, opened the native picker, selected `/tmp/m2-live.png`, and confirmed the second review showed the pinned destination plus exact `assets/Furniture/Office/m2-live.png` target. Cancel closed the review and a filesystem assertion confirmed that no target was published. |
|
||||
| Destination-first skeletal import and placement | Pass | Chose **Import Here** in `assets/Furniture/Office/`, imported `blacksite-m2-robot-expressive.glb` directly there, inspected its stable draw-slot IDs, and placed it as a live `SkinnedMesh` actor with its skeleton hierarchy intact. Registry ID `5b4640dd-fc17-4703-b9ea-e4eb49a8c7fc` and both generated manifests survived the final headless refresh. |
|
||||
| Editable material extraction | Pass | The review exposed the converted metallic/roughness values, base/normal/packed texture channels, double-sided state, destination path, and stable source provenance before one transactional publication. |
|
||||
| Re-extraction diff/apply safety | Pass after corrective implementation | Native review found the provenance-matched Material, exposed a source-revision diff, and kept Extract disabled until **Apply Reviewed Update** or **Create New Copy** was chosen. Apply preserved Material ID `647a63d4-64c6-4431-ba46-9efdd515cd8f`, mapped all eight active slots, and **Undo Content** restored the exact prior Material bytes. Pipeline tests additionally prove external-edit rejection and exact-byte rollback when dependent publication fails; editor tests prove undecided and stale reviews cannot publish. |
|
||||
| Extract-and-map contract | Pass after corrective implementation | Native QA found that extraction initially created the Material without changing model defaults. The transaction now registers the Material and maps all nine draw-slot IDs using source material 0 before publishing either registry document; the generated static-mesh manifest contains the same nine `Project(...)` selections. |
|
||||
| Guarded create/write undo | Pass | **Undo Content** moved the first extracted Material into one Trash batch while leaving the model bundle untouched. The corrected extraction was then rerun against the same fixture. |
|
||||
| Forward/Solari DefaultGrid visibility | Pass | The scene's UV-independent neutral grid remained visible in `Lit / Forward` and after applying `GiMode::Solari` in memory; `assets/project.ron` remained configured as `Forward`. |
|
||||
| Broken project fallback safety | Pass | Selected `new_material_2` as the project fallback, moved that Material to Trash through the reviewed transaction, and confirmed affected primitives and the placed skinned model remained visible with DefaultGrid. Undo restored the Material; the project fallback was then cleared back to the built-in default. |
|
||||
| Skinned scene-slot override | Pass | The Inspector exposed every imported draw slot and its stable ID. Assigning `new_material_2` to the first slot changed only that scene slot to an explicit project Material while the remaining slots continued to report imported-source fallback. |
|
||||
| Restart persistence and deterministic refresh | Pass | After a clean close/restart, the registry, runtime catalog, generated static-mesh manifest, and extracted Material retained identical SHA-256 hashes. Registry and manifest each retained nine project slot selections. |
|
||||
| Editor/headless classification parity | Pass after corrective implementation | `process-assets --check` found that browser sync had collapsed a schema-classified Material Instance back to Material. Browser registry sync now reclassifies the authored file while retaining the unified visible Material family. A steady-state editor restart preserved both document hashes and the following headless check reported zero changes. |
|
||||
| Reimport and orphan reconciliation | Pass after corrective implementation | Removing source node 8 from the QA glTF and choosing **Reimport** retained eight active `Project(...)` mappings by stable slot ID and exposed the removed mapping as one explicit orphan. **Locate** selected its extracted Material; **Clear Orphan** plus **Apply** published eight active mappings and zero orphans to registry and runtime manifests. The source bundle under `source_assets/` was not modified. |
|
||||
| Move/rename stable identity | Pass after corrective implementation | A reviewed Cut/Paste moved `assets/Props/Office/` to `assets/Furniture/Office/` while preserving model ID `36c51ff3-29ae-4ab1-aaca-f90f57e27966` and Material ID `647a63d4-64c6-4431-ba46-9efdd515cd8f`. Native QA found stale nested `MaterialRef.source_path` caches on the first attempt; guarded Undo restored the prior bytes, the transaction rewrite was corrected, and the repeated move updated registry, catalog, both model manifests, Material provenance, and texture paths. Reimport at the destination retained all eight mappings. |
|
||||
| Duplicate identity and internal references | Pass after corrective implementation | Native **Duplicate** assigned fresh IDs to the copied model, Material, and textures; every copied model slot referenced the copied Material and folder, while the original records remained unchanged. Copied models discarded inherited manifest paths and the watcher regenerated static/animation manifests under the copied model ID. |
|
||||
| Duplicate guarded undo and derived cleanup | Pass after corrective implementation | Native Undo initially exposed orphan generated manifests after removing the copied tree. Trash manifest schema v2 now includes model static/animation artifacts. Rebuilt native Duplicate -> Undo moved the copy plus both generated manifests into one restorable Trash batch, removed copied registry/catalog records, and preserved the original tree and artifacts. |
|
||||
|
||||
## Automated and Packaged Acceptance
|
||||
|
||||
The same local implementation passed the complete workspace/all-feature test suite, strict
|
||||
all-target/all-feature Clippy with warnings denied, formatting, both project validators, and a
|
||||
steady-state headless content check over 78 discovered assets. `validate-levels` audited 152
|
||||
dependencies with zero blockers; `validate-samples` audited all five samples and 157 dependencies
|
||||
with zero blockers. Both validators reported the expected eight non-blocking import/platform
|
||||
findings. The final `process-assets --check` reported zero registry, catalog, model, texture, or
|
||||
material-artifact changes. The QA package published 125 runtime files (87 written and 38 reused)
|
||||
with no stale packaged files.
|
||||
|
||||
Focused Content Browser regressions also cover guarded undo for created folders and copied content:
|
||||
an unchanged created result is targeted as one restorable Trash batch, while any external tree
|
||||
change blocks the undo and preserves the workspace. Ordinary Move to Trash records its exact batch
|
||||
for guarded Ctrl/Cmd+Z restoration as well. Model trash/restore additionally verifies byte-exact
|
||||
static/animation manifest removal and restoration, and copy coverage verifies fresh IDs plus
|
||||
internal-only reference remapping.
|
||||
|
||||
The final transaction audit adds focused coverage for exact browser/scene status restoration when
|
||||
a content review is cancelled, stale-drag cleanup, registry/runtime-catalog drift refusal during an
|
||||
import review, and reviewed-import rollback that removes newly published bytes without deleting an
|
||||
in-project adopted asset. Destructive reference discovery reports external authored documents,
|
||||
project defaults, model mappings, and dependency records while excluding references removed in the
|
||||
same selected tree. Ambiguous out-of-editor fingerprint moves now leave registry/manifests
|
||||
unchanged and open an explicit identity-repair review in the editor; the user can preserve one
|
||||
candidate ID or intentionally register the file as new. Headless processing reports both candidate
|
||||
paths until that choice is published instead of silently allocating a replacement ID.
|
||||
Focused repair coverage proves preserved-ID continuity through the next shared scan, intentional
|
||||
new-ID behavior, duplicate-ID rejection, and one commit that publishes the world registry, registry
|
||||
file, and stripped runtime catalog together. Content shortcuts are also suppressed while a browser
|
||||
review or popup owns input, and Cut/Paste keeps the requested name so collisions reach review.
|
||||
The follow-up QoL audit made right-click targeting consistent for files, folders, and embedded
|
||||
subassets; distinguishes nested selections covered by a selected parent from genuinely unaffected
|
||||
built-ins/subassets; and clears selection when search/scope/type filters would hide it. Browser
|
||||
controls are disabled behind reviews. Startup, manual Refresh, and watcher processing now share the
|
||||
same pipeline, rediscover unresolved move repairs after restart, and selection-only changes no
|
||||
longer trigger whole-catalog fingerprint or registry work.
|
||||
A rebuilt native editor then mapped successfully on the live Wayland session with the shared
|
||||
startup refresh active. The Details drag strip now uses one stable explicit egui ID across layout
|
||||
passes; a final bounded launch produced no resize-handle ID warning, and the following headless
|
||||
check again reported zero content changes.
|
||||
|
||||
The architecture audit also moved destination-first import planning/publication, source
|
||||
fingerprints, static-mesh normalization, animation normalization, and combined model-artifact
|
||||
publication into `content_pipeline`. The `process-assets` feature's dependency tree no longer
|
||||
contains the editor crate; the editor retains compatibility re-exports for its UI consumers.
|
||||
|
||||
The extraction correction adds focused coverage for dependent registry edits that can see newly
|
||||
registered asset IDs, byte-restoring rollback when that dependent edit fails, and source-index
|
||||
mapping across every draw slot that uses an extracted source material. Re-extraction coverage also
|
||||
requires an explicit decision for provenance matches, rejects stale external edits, preserves the
|
||||
existing asset ID on Apply, and restores exact prior bytes if dependent publication fails.
|
||||
|
||||
Property-block coverage verifies owner/slot-local Standard handles, stable handle counts across
|
||||
repeated application, strongest precedence above an existing Material Instance on the Surface
|
||||
path, and whole-block rejection for invalid Standard/schema/type/range/texture input. Invalid
|
||||
blocks leave the resolved base handle visible and emit one deduplicated diagnostic.
|
||||
|
||||
The reviewed promotion transaction has focused coverage for a direct Material and an existing
|
||||
Material Instance base, exact-slot assignment, one scene-history edit, cancel without mutation,
|
||||
source/slot/schema/block/target conflicts after review, invalid runtime input, and restoration of
|
||||
the exact prior file, registry, and runtime-catalog bytes when the scene edit fails. The import
|
||||
review likewise has focused coverage for non-mutating planning, collision refusal, post-review
|
||||
source/registry/runtime-catalog changes, complete textual-glTF dependency fingerprints, artifact
|
||||
processing failure with whole-bundle rollback, adopted-file preservation, and an explicitly pinned
|
||||
Import To destination that does not change the visible browser location.
|
||||
|
||||
The final native promotion scenario used the editor-only BRP reflection boundary to inject a
|
||||
two-parameter `MaterialPropertyBlock` into Ground's exact `slot:primitive:surface`. The Inspector
|
||||
reviewed and published one sparse direct-base Material Instance, assigned it to only that primitive
|
||||
slot through one history edit, and removed the runtime block only after publication succeeded.
|
||||
BRP readback proved the exact Material Instance reference and absence of the runtime component;
|
||||
Undo restored the original Pebble Bricks slot. The temporary instance, registry, catalog, scene,
|
||||
and Pebble fixture were then restored to their pre-scenario bytes. Runtime blocks remain absent
|
||||
from Add Component and scene/prefab persistence; no QA-only authoring component was added.
|
||||
|
||||
The final moved/reimported QA fixture hashes were:
|
||||
|
||||
- registry: `e1eb425c2d52be06d7db840df1f14f1d3a96daf2c1876dfc025d861bf0d32b74`
|
||||
- runtime catalog: `cc296049b656d52e3159cca2e11f52bc4bdef0c922fb0dc00fa5d33f4e3748e7`
|
||||
- desk static-mesh manifest: `6c69a9f9502fce36cb88e82a7e2e2074e6279ca6da4d49e3e36c1ede35c0577f`
|
||||
- desk animation manifest: `8a0632bd8b6ea4a5d117214ea168f4020f9399c92bb9da3d7cba1ad371b9e4e8`
|
||||
- extracted desk Material: `70e498f596d37da5735f5e0d0b1f3834442cd1aefa698232a640fec9d9e422f3`
|
||||
- skeletal static-mesh manifest: `ee9168b123d89ff57b312a35e54a3a8d5bf5b9dae3ed98e79c7bc24dcb6d6454`
|
||||
- skeletal animation manifest: `7c14b6ad016db5c09af7f56f50492a05f9bdd89b1bb672e9886bc9a3447e2130`
|
||||
|
||||
The latest 2026-07-14 rerun of `cargo package-project --profile development` wrote zero changed
|
||||
files and reused 74 unchanged files. The packaged
|
||||
`assets/content.catalog.ron` was byte-identical to the source runtime catalog with SHA-256
|
||||
`cc296049b656d52e3159cca2e11f52bc4bdef0c922fb0dc00fa5d33f4e3748e7`. A bounded native package
|
||||
launch hydrated the authored scene and visibly rendered the world-space DefaultGrid across UV-less
|
||||
primitives and the floor. The corrective binary also mapped a live 3426x1384 Hyprland window as
|
||||
class `bevy-fps-foundation`, title `Bevy FPS Foundation`, before the bounded QA process stopped.
|
||||
|
||||
## Screenshot Captures
|
||||
|
||||
The native PNGs are retained locally pending upload as Gitea issue attachments. Repository image
|
||||
copies are intentionally not required by the evaluation policy.
|
||||
|
||||
| Capture | Dimensions | SHA-256 |
|
||||
|---------|------------|---------|
|
||||
| `blacksite-m2-managed-hidden.png` | 3426x1384 RGB PNG | `97bb710d569039b54218a556865f366cff3bda2ae6ce3afe4a1933db8e58c36b` |
|
||||
| `blacksite-m2-empty-clears-selection.png` | 3426x1384 RGB PNG | `e162c865202717cf36eec7a37c3f95a4cc4c3c55dcc5d48243b00fe47be0d136` |
|
||||
| `blacksite-m2-multiselect-fixed-2.png` | 3426x1384 RGB PNG | `729ae5d2b10ca2d8acdd249f19c35f5e6f3a57d9dbb9550f80c371b703336868` |
|
||||
| `blacksite-m2-multiselect-context.png` | 3426x1384 RGB PNG | `88232360d592a1e4436e86a17fe1356ea10d7766cfbdb98eb6323767cbc16fe6` |
|
||||
| `blacksite-m2-item-context.png` | 3426x1384 RGB PNG | `6f01f23ea7ad65dffecd0d0e51e57b6a1fcf26cf06cfe6f536f8376557a6649b` |
|
||||
| `blacksite-m2-details-resized.png` | 3426x1384 RGB PNG | `407ee7779367f83ca2a9c5d6f4a5803584609e319d881265f9544b194fbd0296` |
|
||||
| `blacksite-m2-office-empty-context.png` | 3426x1384 RGB PNG | `a4004292f70b8a07f6c0d24e8bc47c1716e7de33b4b627a67c4198afe76a00a3` |
|
||||
| `blacksite-m2-imported-model-details.png` | 3426x1384 RGB PNG | `cf68b41293b823945fdd17e9752d3733f8d38144504f5fdbfd9be7f793ce0205` |
|
||||
| `blacksite-m2-extraction-review.png` | 3426x1384 RGB PNG | `f4d567d3353536ca1492d48fe59f72ff5b3e4b37c095ef27eaed51347c6a67ec` |
|
||||
| `blacksite-m2-extraction-transaction.png` | 3426x1384 RGB PNG | `99944392580a88ec14868dbf5a422bacc89ca3b8d8d0750311f429e65250aef6` |
|
||||
| `blacksite-m2-details-wide-mapped.png` | 3426x1384 RGB PNG | `6aee075b4006909cde1625d5afd42a8be93b9323de93156bd8a55d27ef07e678` |
|
||||
| `blacksite-m2-defaultgrid-solari.png` | 3426x1384 RGB PNG | `9f23685f6354029ce772878a3f080c7efb045ccc73fce6c19f8fe7802e378ee8` |
|
||||
| `blacksite-m2-orphan-controls.png` | 3426x1384 RGB PNG | `afe8f07d92c00ac1294b021682a66ea623b3c22158598119d2617f2e0b1dae72` |
|
||||
| `blacksite-m2-orphan-locate.png` | 3426x1384 RGB PNG | `d7c841747e1a712da80537846699baa8b2f83f91a65ddc298d1d3e665f2e74b7` |
|
||||
| `blacksite-m2-orphan-applied.png` | 3426x1384 RGB PNG | `c979981fba5b30692c3f858fd349b582bb204b5720702bd684f3721ed5a76350` |
|
||||
| `blacksite-m2-root-empty-context.png` | 3426x1384 RGB PNG | `960231dc8661f7b012abf7ddf0cc97ce42548e789e911895e12b8b800b29153d` |
|
||||
| `blacksite-m2-office-move-review-fixed.png` | 3426x1384 RGB PNG | `aaa06af27049858f2c691b9c251197a19a5330919048b59b2c313d06d2bf4471` |
|
||||
| `blacksite-m2-office-moved-fixed.png` | 3426x1384 RGB PNG | `0cfdd6206d56355583c55e483959c8c154223acf5142015f9f2329da54baf5ca` |
|
||||
| `blacksite-m2-moved-model-reimported.png` | 3426x1384 RGB PNG | `a6420434c25f72af94f1f4bdb22c8686bd840aad5fe114c192bdefc6db020aec` |
|
||||
| `blacksite-m2-duplicate-review.png` | 3426x1384 RGB PNG | `f0fae051ca8c807540779de662a5381b3e9f1ac3faaf1cd5412bb7f1cb2835b0` |
|
||||
| `blacksite-m2-duplicate-committed.png` | 3426x1384 RGB PNG | `3e3b0fd38f0374c47598307d93f5238028d269753742f4b296536f0fe886c1a5` |
|
||||
| `blacksite-m2-duplicate-undo-clean-editor.png` | 3426x1384 RGB PNG | `45aaa55e2069de66d9eb86f4157fd143d92afa2de07aaefb0bb2cc960958401a` |
|
||||
| `blacksite-m2-packaged-live-window.png` | 3426x1384 RGB PNG | `de8c19b2dbc2b488e290b5e4d1bd3e1c279388374a81e25a5684dd2454f58ee2` |
|
||||
| `blacksite-m2-reextract-modal.png` | 1440x3440 RGB PNG | `b7139a3b6da88755be1c53ef9921450449f207a3082248efd8199bd8abdea515` |
|
||||
| `blacksite-m2-reextract-selected.png` | 1440x3440 RGB PNG | `bd22912ff3d2e4bfdab6469909344a0b0e94f8309665ad876e98e43fe7c80563` |
|
||||
| `blacksite-m2-reextract-applied.png` | 1440x3440 RGB PNG | `007164ae995c64f048aac638e20664fc173769945691afc3e6a0a6fbf4704380` |
|
||||
| `blacksite-m2-reextract-undo.png` | 1440x3440 RGB PNG | `3f95eec702d4df6a55d88132c82282311d96d3bca15e2a8ebe11d06ee408461b` |
|
||||
| `m2-skeletal-import-review.png` | 1440x3440 RGB PNG | `a08dc1d17848d3089d601c8b31c697c5f22b36dda625baf5fa8f52ee7dad2ea2` |
|
||||
| `m2-skeletal-selected.png` | 1440x3440 RGB PNG | `2867517356b63a1b7627d5d069e7b45150325065ef247ff20a06c00b53c79581` |
|
||||
| `m2-skeletal-placed.png` | 1440x3440 RGB PNG | `1936dfcd84d9a6e6cf8f293f71d8a4cb89d1761ad9ee982954ad25682cfd999d` |
|
||||
| `m2-project-default-selected.png` | 1440x3440 RGB PNG | `ee3d5385ccd7af1d099a042fb02400e1e193374ca475a28b3d7f55d483d64547` |
|
||||
| `m2-project-default-broken-fallback.png` | 1440x3440 RGB PNG | `5efb715a619456afcbee808d13f7b4c2cf24bb975f6b69671401bba1fed07ba0` |
|
||||
| `m2-inspector-open.png` | 1440x3440 RGB PNG | `7ae9d456d0924ab50012ecbefb8e42847ccb141793ce89487c0fd2fbd2b8307e` |
|
||||
| `m2-skeletal-scene-override.png` | 1440x3440 RGB PNG | `3c7ec6fce6a09f9e46402aa64dda77c5508703a11149b30297cee80d9e7907af` |
|
||||
| `m2-import-to-selected.png` | 1440x3440 RGB PNG | `d9cb38de6fca185dab6887324163698b2ac036e8f5eb19f16fb65415172f9605` |
|
||||
| `m2-import-review.png` | 1440x3440 RGB PNG | `631e1ac1d3c63d72d7c930c3b4789584e15a178f03425fd972df82da51dcfa05` |
|
||||
| `property-block-promotion-20260717T130300Z.png` | 3426x1384 RGB PNG | `69cd668618206b1cee25142521127882cc785031e8e7cd21684c1eab7c97befa` |
|
||||
|
||||
## Remaining Release Use
|
||||
|
||||
The complete deterministic candidate gate passes on the local candidate tree. After assigning its
|
||||
exact commit, confirm the clean-tree evidence digest, publish the native/candidate evidence on
|
||||
Gitea, and finish with issue/milestone readback. The local candidate tree covers static and skeletal
|
||||
import, edit/reimport/orphan resolution, broken project fallback, scene-slot precedence, reviewed
|
||||
Import To cancellation, runtime-injected property-block promotion, responsive Penpot material UI,
|
||||
dirty/save/restart behavior, and packaged runtime behavior. Publication readback—not another
|
||||
destructive native content-authoring repetition—is the remaining release use of this record.
|
||||
@@ -0,0 +1,40 @@
|
||||
# M2 Penpot Design Exports
|
||||
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../../README.md) 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.
|
||||
|
||||
## Responsive Inspector targets
|
||||
|
||||
| Export | Penpot page and shape | Required match |
|
||||
|---|---|---|
|
||||
| [Materials — wide](materials-wide-620.svg) | 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](materials-narrow-420.svg) | 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](static-mesh-renderer-wide-760.svg) | 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](static-mesh-renderer-narrow-480.svg) | Page 02, `6cb78075-fbd0-8045-8008-57f5419afad2` | Full 480 px renderer composition and bounded narrow reflow. |
|
||||
|
||||
## Shared component targets
|
||||
|
||||
| Export | Penpot page and shape | Required match |
|
||||
|---|---|---|
|
||||
| [Foundation components catalog](foundation-components-catalog.svg) | 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](component-header-50.svg) | Page 12, `83c3baf0-0e37-808a-8008-57cd2388f9b9` | One reusable 50 px component header and action/status geometry. |
|
||||
| [Array header](array-header-40.svg) | Page 12, `83c3baf0-0e37-808a-8008-57cd23947466` | One reusable 40 px collection header. |
|
||||
| [Composition rule](component-composition-rule.svg) | Page 12, `83c3baf0-0e37-808a-8008-57cd23a58de0` | Component containment and section ownership rule. |
|
||||
| [Material components and states](material-components-states.svg) | 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](color-picker-wheel.svg) | Page 22, `83c3baf0-0e37-808a-8008-57cd9b7b0667` | Wheel mode layout, current/previous values, alpha, recents, and footer behavior. |
|
||||
| [Adjusted wheel state](color-picker-adjusted.svg) | Page 22, `83c3baf0-0e37-808a-8008-57cd9bbd9c3b` | Dirty preview state and exact value presentation. |
|
||||
| [Sliders](color-picker-sliders.svg) | Page 23, `83c3baf0-0e37-808a-8008-57cda8a2c70f` | Sliders mode layout and conversion controls. |
|
||||
| [Presets](color-picker-presets.svg) | 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.
|
||||
- **#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.
|
||||
@@ -0,0 +1,14 @@
|
||||
<svg width="762" xmlns="http://www.w3.org/2000/svg" height="42" id="screenshot-83c3baf0-0e37-808a-8008-57cd23947466" viewBox="-1 -1 762 42" xmlns:xlink="http://www.w3.org/1999/xlink" fill="none" version="1.1"><style>@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 400;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-regular.woff) format('woff');
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 700;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-bold.woff) format('woff');
|
||||
}</style><g id="shape-83c3baf0-0e37-808a-8008-57cd23947466"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd23947466"><rect width="759.9999904632459" height="39.99999821186066" class="frame-background" x="0" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(21, 24, 28); fill-opacity: 1;" ry="4" rx="4" y="0"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57cd2394a883"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd2394a883"><rect rx="0" ry="0" x="9.999958634377663" y="13.000028308378319" width="13.999999761578692" height="13.99999952316216" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57cd2394a884" width="16" height="16" rx="0" ry="0" style="fill: rgb(0, 0, 0);"><g id="shape-83c3baf0-0e37-808a-8008-57cd2394a885" style="display: none;"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd2394a885"><rect width="13.999999761578692" height="13.99999952316216" x="9.999958634377663" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: none;" ry="0" fill="none" rx="0" y="13.000028308378319"/></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cd2394a886"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd2394a886"><path d="M15.468711853027344,14.968780517578125L13.062461853027344,14.968780517578125C12.458335876464844,14.968780517578125,11.968711853027344,15.458404541015625,11.968711853027344,16.062530517578125L11.968711853027344,18.468780517578125C11.968711853027344,19.072906494140625,12.458335876464844,19.562530517578125,13.062461853027344,19.562530517578125L15.468711853027344,19.562530517578125C16.072837829589844,19.562530517578125,16.562461853027344,19.072906494140625,16.562461853027344,18.468780517578125L16.562461853027344,16.062530517578125C16.562461853027344,15.458404541015625,16.072837829589844,14.968780517578125,15.468711853027344,14.968780517578125M15.249961853027344,18.250030517578125L13.281211853027344,18.250030517578125L13.281211853027344,16.281280517578125L15.249961853027344,16.281280517578125ZM20.937461853027344,14.968780517578125L18.531211853027344,14.968780517578125C17.927085876464844,14.968780517578125,17.437461853027344,15.458404541015625,17.437461853027344,16.062530517578125L17.437461853027344,18.468780517578125C17.437461853027344,19.072906494140625,17.927085876464844,19.562530517578125,18.531211853027344,19.562530517578125L20.937461853027344,19.562530517578125C21.541587829589844,19.562530517578125,22.031211853027344,19.072906494140625,22.031211853027344,18.468780517578125L22.031211853027344,16.062530517578125C22.031211853027344,15.458404541015625,21.541587829589844,14.968780517578125,20.937461853027344,14.968780517578125M20.718711853027344,18.250030517578125L18.749961853027344,18.250030517578125L18.749961853027344,16.281280517578125L20.718711853027344,16.281280517578125ZM15.468711853027344,20.437530517578125L13.062461853027344,20.437530517578125C12.458335876464844,20.437530517578125,11.968711853027344,20.927154541015625,11.968711853027344,21.531280517578125L11.968711853027344,23.937530517578125C11.968711853027344,24.541656494140625,12.458335876464844,25.031280517578125,13.062461853027344,25.031280517578125L15.468711853027344,25.031280517578125C16.072837829589844,25.031280517578125,16.562461853027344,24.541656494140625,16.562461853027344,23.937530517578125L16.562461853027344,21.531280517578125C16.562461853027344,20.927154541015625,16.072837829589844,20.437530517578125,15.468711853027344,20.437530517578125M15.249961853027344,23.718780517578125L13.281211853027344,23.718780517578125L13.281211853027344,21.750030517578125L15.249961853027344,21.750030517578125ZM20.937461853027344,20.437530517578125L18.531211853027344,20.437530517578125C17.927085876464844,20.437530517578125,17.437461853027344,20.927154541015625,17.437461853027344,21.531280517578125L17.437461853027344,23.937530517578125C17.437461853027344,24.541656494140625,17.927085876464844,25.031280517578125,18.531211853027344,25.031280517578125L20.937461853027344,25.031280517578125C21.541587829589844,25.031280517578125,22.031211853027344,24.541656494140625,22.031211853027344,23.937530517578125L22.031211853027344,21.531280517578125C22.031211853027344,20.927154541015625,21.541587829589844,20.437530517578125,20.937461853027344,20.437530517578125M20.718711853027344,23.718780517578125L18.749961853027344,23.718780517578125L18.749961853027344,21.750030517578125L20.718711853027344,21.750030517578125Z" style="fill: rgb(155, 163, 171); fill-opacity: 1;"/></g></g></g></g></g></g></g></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cd2394a87d" rx="0" ry="0" style="display: none; fill: rgLine truncated
|
||||
|
After Width: | Height: | Size: 19 KiB |
@@ -0,0 +1,14 @@
|
||||
<svg width="774.04" xmlns="http://www.w3.org/2000/svg" height="670" id="screenshot-83c3baf0-0e37-808a-8008-57cd9bbd9c3b" viewBox="-134.04 0 774.04 670" xmlns:xlink="http://www.w3.org/1999/xlink" fill="none" version="1.1"><style>@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 700;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-bold.woff) format('woff');
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 400;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-regular.woff) format('woff');
|
||||
}</style><g id="shape-83c3baf0-0e37-808a-8008-57cd9bbd9c3b"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd9bbd9c3b"><rect rx="0" ry="0" x="0" y="0" width="640" height="670" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57cd9bbd9c3c" style="opacity: 0.62;"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd9bbd9c3c"><rect rx="0" ry="0" x="0" y="0" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" width="640" height="670" style="fill: rgb(7, 8, 10); fill-opacity: 1;"/></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cd9bbd9c3d"><defs><clipPath id="frame-clip-83c3baf0-0e37-808a-8008-57cd9bbd9c3d-render-3" class="frame-clip frame-clip-def"><rect rx="7" ry="7" x="110" y="228" width="420" height="350" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-83c3baf0-0e37-808a-8008-57cd9bbd9c3d-render-3)" fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd9bbd9c3d"><rect width="420" height="350" class="frame-background" x="110" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(21, 24, 28); fill-opacity: 1;" ry="7" rx="7" y="228"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57cd9bbd9c3e"><defs><clipPath id="frame-clip-83c3baf0-0e37-808a-8008-57cd9bbd9c3e-render-4" class="frame-clip frame-clip-def"><rect rx="0" ry="0" x="110" y="228" width="420" height="38" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-83c3baf0-0e37-808a-8008-57cd9bbd9c3e-render-4)" fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd9bbd9c3e"><rect width="420" height="38" class="frame-background" x="110" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(21, 24, 28); fill-opacity: 1;" ry="0" rx="0" y="228"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57cd9bbd9c3f"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="122" y="236" width="61" height="16" rx="0" ry="0"><defs><pattern patternUnits="objectBoundingBox" width="58.1400146484375" height="16.840087890625" id="fill-0-render-5-0"><g><rect width="58.1400146484375" height="16.840087890625" style="fill: rgb(220, 225, 229); fill-opacity: 1;"/></g></pattern></defs><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd9bbd9c3f"><text x="122" y="252.6201171875" dominant-baseline="ideographic" textLength="58.1400146484375" lengthAdjust="spacingAndGlyphs" style="text-transform: none; font-family: sourcesanspro; letter-spacing: 0px; font-style: normal; font-weight: 700; white-space: pre; font-size: 13px; text-decoration: none; direction: ltr; fill: rgb(220, 225, 229); fill-opacity: 1;">Base Color</text></g></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cd9bbd9c40"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="194" y="238" width="52" height="12" rx="0" ry="0"><defs><pattern patternUnits="objectBoundingBox" width="51.850006103515625" height="12.93994140625" id="fill-0-render-6-0"><g><rect width="51.850006103515625" height="12.93994140625" style="fill: rgb(155, 163, 171); fill-opacity: 1;"/></g></pattern></defs><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd9bbd9c40"><text x="194" y="250.469970703125" dominant-baseline="ideographic" textLength="51.850006103515625" lengthAdjust="spacingAndGlyphs" style="text-transform: none; font-family: sourcesanspro; letter-spacing: 0px; font-style: normal; font-weight: 400; white-space: pre; font-size: 10px; text-decoration: none; direction: ltr; fill: rgb(155, 163, 171); fill-opacity: 1;">sRGB · RGBA</text></g></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cd9bbd9c41"><defs><clipPath id="frame-clip-83c3baf0-0e37-808a-8008-57cd9bbd9c41-render-7" class="frame-clip frame-clip-def"><rect rx="4" ry="4" x="458" y="235" width="26" height="24" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-83c3baf0-0e37-808a-8008-57cd9bbd9c41-render-7)" fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd9bbd9c41"><rect width="26" height="24" class="frame-background" x="458" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(83, 211, 230Line truncated
|
||||
|
After Width: | Height: | Size: 129 KiB |
@@ -0,0 +1,14 @@
|
||||
<svg width="640" xmlns="http://www.w3.org/2000/svg" height="670" id="screenshot-83c3baf0-0e37-808a-8008-57cda8c84257" viewBox="0 0 640 670" xmlns:xlink="http://www.w3.org/1999/xlink" fill="none" version="1.1"><style>@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 700;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-bold.woff) format('woff');
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 400;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-regular.woff) format('woff');
|
||||
}</style><g id="shape-83c3baf0-0e37-808a-8008-57cda8c84257"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cda8c84257"><rect rx="0" ry="0" x="0" y="0" width="640" height="670" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57cda8c84258" style="opacity: 0.62;"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cda8c84258"><rect rx="0" ry="0" x="0" y="0" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" width="640" height="670" style="fill: rgb(7, 8, 10); fill-opacity: 1;"/></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cda8c84259"><defs><clipPath id="frame-clip-83c3baf0-0e37-808a-8008-57cda8c84259-render-3" class="frame-clip frame-clip-def"><rect rx="7" ry="7" x="110" y="228" width="420" height="350" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-83c3baf0-0e37-808a-8008-57cda8c84259-render-3)" fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cda8c84259"><rect width="420" height="350" class="frame-background" x="110" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(21, 24, 28); fill-opacity: 1;" ry="7" rx="7" y="228"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57cda8c8425a"><defs><clipPath id="frame-clip-83c3baf0-0e37-808a-8008-57cda8c8425a-render-4" class="frame-clip frame-clip-def"><rect rx="0" ry="0" x="110" y="228" width="420" height="38" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-83c3baf0-0e37-808a-8008-57cda8c8425a-render-4)" fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cda8c8425a"><rect width="420" height="38" class="frame-background" x="110" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(21, 24, 28); fill-opacity: 1;" ry="0" rx="0" y="228"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57cda8c8425b"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="122" y="236" width="61" height="16" rx="0" ry="0"><defs><pattern patternUnits="objectBoundingBox" width="60.8499755859375" height="17.899993896484375" id="fill-0-render-5-0"><g><rect width="60.8499755859375" height="17.899993896484375" style="fill: rgb(220, 225, 229); fill-opacity: 1;"/></g></pattern></defs><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cda8c8425b"><text x="122" y="253.14999389648438" dominant-baseline="ideographic" textLength="60.8499755859375" lengthAdjust="spacingAndGlyphs" style="text-transform: none; font-family: sourcesanspro; letter-spacing: 0px; font-style: normal; font-weight: 700; white-space: pre; font-size: 13px; text-decoration: none; direction: ltr; fill: rgb(220, 225, 229); fill-opacity: 1;">Base Color</text></g></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cda8c8425c"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="194" y="238" width="52" height="12" rx="0" ry="0"><defs><pattern patternUnits="objectBoundingBox" width="51.8499755859375" height="12.94000244140625" id="fill-0-render-6-0"><g><rect width="51.8499755859375" height="12.94000244140625" style="fill: rgb(155, 163, 171); fill-opacity: 1;"/></g></pattern></defs><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cda8c8425c"><text x="194" y="250.47000122070312" dominant-baseline="ideographic" textLength="51.8499755859375" lengthAdjust="spacingAndGlyphs" style="text-transform: none; font-family: sourcesanspro; letter-spacing: 0px; font-style: normal; font-weight: 400; white-space: pre; font-size: 10px; text-decoration: none; direction: ltr; fill: rgb(155, 163, 171); fill-opacity: 1;">sRGB · RGBA</text></g></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cda8c8425d"><defs><clipPath id="frame-clip-83c3baf0-0e37-808a-8008-57cda8c8425d-render-7" class="frame-clip frame-clip-def"><rect rx="4" ry="4" x="458" y="235" width="26" height="24" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-83c3baf0-0e37-808a-8008-57cda8c8425d-render-7)" fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cda8c8425d"><rect width="26" height="24" class="frame-background" x="458" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(Line truncated
|
||||
|
After Width: | Height: | Size: 89 KiB |
@@ -0,0 +1,14 @@
|
||||
<svg width="640" xmlns="http://www.w3.org/2000/svg" height="670" id="screenshot-83c3baf0-0e37-808a-8008-57cda8a2c70f" viewBox="0 0 640 670" xmlns:xlink="http://www.w3.org/1999/xlink" fill="none" version="1.1"><style>@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 700;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-bold.woff) format('woff');
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 400;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-regular.woff) format('woff');
|
||||
}</style><g id="shape-83c3baf0-0e37-808a-8008-57cda8a2c70f"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cda8a2c70f"><rect rx="0" ry="0" x="0" y="0" width="640" height="670" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57cda8a2c710" style="opacity: 0.62;"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cda8a2c710"><rect rx="0" ry="0" x="0" y="0" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" width="640" height="670" style="fill: rgb(7, 8, 10); fill-opacity: 1;"/></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cda8a2c711"><defs><clipPath id="frame-clip-83c3baf0-0e37-808a-8008-57cda8a2c711-render-3" class="frame-clip frame-clip-def"><rect rx="7" ry="7" x="110" y="228" width="420" height="350" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-83c3baf0-0e37-808a-8008-57cda8a2c711-render-3)" fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cda8a2c711"><rect width="420" height="350" class="frame-background" x="110" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(21, 24, 28); fill-opacity: 1;" ry="7" rx="7" y="228"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57cda8a2c712"><defs><clipPath id="frame-clip-83c3baf0-0e37-808a-8008-57cda8a2c712-render-4" class="frame-clip frame-clip-def"><rect rx="0" ry="0" x="110" y="228" width="420" height="38" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-83c3baf0-0e37-808a-8008-57cda8a2c712-render-4)" fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cda8a2c712"><rect width="420" height="38" class="frame-background" x="110" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(21, 24, 28); fill-opacity: 1;" ry="0" rx="0" y="228"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57cda8a2c713"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="122" y="236" width="61" height="16" rx="0" ry="0"><defs><pattern patternUnits="objectBoundingBox" width="60.850006103515625" height="17.899993896484375" id="fill-0-render-5-0"><g><rect width="60.850006103515625" height="17.899993896484375" style="fill: rgb(220, 225, 229); fill-opacity: 1;"/></g></pattern></defs><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cda8a2c713"><text x="122" y="253.14999389648438" dominant-baseline="ideographic" textLength="60.850006103515625" lengthAdjust="spacingAndGlyphs" style="text-transform: none; font-family: sourcesanspro; letter-spacing: 0px; font-style: normal; font-weight: 700; white-space: pre; font-size: 13px; text-decoration: none; direction: ltr; fill: rgb(220, 225, 229); fill-opacity: 1;">Base Color</text></g></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cda8a2c714"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="194" y="238" width="52" height="12" rx="0" ry="0"><defs><pattern patternUnits="objectBoundingBox" width="51.850006103515625" height="12.94000244140625" id="fill-0-render-6-0"><g><rect width="51.850006103515625" height="12.94000244140625" style="fill: rgb(155, 163, 171); fill-opacity: 1;"/></g></pattern></defs><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cda8a2c714"><text x="194" y="250.47000122070312" dominant-baseline="ideographic" textLength="51.850006103515625" lengthAdjust="spacingAndGlyphs" style="text-transform: none; font-family: sourcesanspro; letter-spacing: 0px; font-style: normal; font-weight: 400; white-space: pre; font-size: 10px; text-decoration: none; direction: ltr; fill: rgb(155, 163, 171); fill-opacity: 1;">sRGB · RGBA</text></g></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cda8a2c715"><defs><clipPath id="frame-clip-83c3baf0-0e37-808a-8008-57cda8a2c715-render-7" class="frame-clip frame-clip-def"><rect rx="4" ry="4" x="458" y="235" width="26" height="24" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-83c3baf0-0e37-808a-8008-57cda8a2c715-render-7)" fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cda8a2c715"><rect width="26" height="24" class="frame-background" x="458" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" styleLine truncated
|
||||
|
After Width: | Height: | Size: 94 KiB |
@@ -0,0 +1,14 @@
|
||||
<svg width="640" xmlns="http://www.w3.org/2000/svg" height="670" id="screenshot-83c3baf0-0e37-808a-8008-57cd9b7b0667" viewBox="0 0 640 670" xmlns:xlink="http://www.w3.org/1999/xlink" fill="none" version="1.1"><style>@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 700;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-bold.woff) format('woff');
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 400;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-regular.woff) format('woff');
|
||||
}</style><g id="shape-83c3baf0-0e37-808a-8008-57cd9b7b0667"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd9b7b0667"><rect rx="0" ry="0" x="0" y="0" width="640" height="670.0000000000005" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57cd9b7b0668" style="opacity: 0.62;"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd9b7b0668"><rect rx="0" ry="0" x="0" y="0" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" width="640" height="670.0000000000005" style="fill: rgb(7, 8, 10); fill-opacity: 1;"/></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cd9b7b0669"><defs><clipPath id="frame-clip-83c3baf0-0e37-808a-8008-57cd9b7b0669-render-3" class="frame-clip frame-clip-def"><rect rx="7" ry="7" x="110" y="228" width="420" height="350" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-83c3baf0-0e37-808a-8008-57cd9b7b0669-render-3)" fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd9b7b0669"><rect width="420" height="350" class="frame-background" x="110" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(21, 24, 28); fill-opacity: 1;" ry="7" rx="7" y="228"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57cd9b7b066a"><defs><clipPath id="frame-clip-83c3baf0-0e37-808a-8008-57cd9b7b066a-render-4" class="frame-clip frame-clip-def"><rect rx="0" ry="0" x="110" y="228" width="420" height="38" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-83c3baf0-0e37-808a-8008-57cd9b7b066a-render-4)" fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd9b7b066a"><rect width="420" height="38" class="frame-background" x="110" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(21, 24, 28); fill-opacity: 1;" ry="0" rx="0" y="228"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57cd9b7b066b"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="122" y="236" width="61" height="16" rx="0" ry="0"><defs><pattern patternUnits="objectBoundingBox" width="60.850006103515625" height="17.899993896484375" id="fill-0-render-5-0"><g><rect width="60.850006103515625" height="17.899993896484375" style="fill: rgb(220, 225, 229); fill-opacity: 1;"/></g></pattern></defs><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd9b7b066b"><text x="122" y="253.14999389648438" dominant-baseline="ideographic" textLength="60.850006103515625" lengthAdjust="spacingAndGlyphs" style="text-transform: none; font-family: sourcesanspro; letter-spacing: 0px; font-style: normal; font-weight: 700; white-space: pre; font-size: 13px; text-decoration: none; direction: ltr; fill: rgb(220, 225, 229); fill-opacity: 1;">Base Color</text></g></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cd9b7b066c"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="194" y="238" width="52" height="12" rx="0" ry="0"><defs><pattern patternUnits="objectBoundingBox" width="51.850006103515625" height="12.94000244140625" id="fill-0-render-6-0"><g><rect width="51.850006103515625" height="12.94000244140625" style="fill: rgb(155, 163, 171); fill-opacity: 1;"/></g></pattern></defs><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd9b7b066c"><text x="194" y="250.47000122070312" dominant-baseline="ideographic" textLength="51.850006103515625" lengthAdjust="spacingAndGlyphs" style="text-transform: none; font-family: sourcesanspro; letter-spacing: 0px; font-style: normal; font-weight: 400; white-space: pre; font-size: 10px; text-decoration: none; direction: ltr; fill: rgb(155, 163, 171); fill-opacity: 1;">sRGB · RGBA</text></g></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cd9b7b066d"><defs><clipPath id="frame-clip-83c3baf0-0e37-808a-8008-57cd9b7b066d-render-7" class="frame-clip frame-clip-def"><rect rx="4" ry="4" x="458" y="235" width="26" height="24" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-83c3baf0-0e37-808a-8008-57cd9b7b066d-render-7)" fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd9b7b066d"><rect width="26" height="24" class="frame-background" x="458" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000Line truncated
|
||||
|
After Width: | Height: | Size: 124 KiB |
@@ -0,0 +1,14 @@
|
||||
<svg width="960" xmlns="http://www.w3.org/2000/svg" height="78" id="screenshot-83c3baf0-0e37-808a-8008-57cd23a58de0" viewBox="0 0 960 78" xmlns:xlink="http://www.w3.org/1999/xlink" fill="none" version="1.1"><style>@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 700;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-bold.woff) format('woff');
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 400;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-regular.woff) format('woff');
|
||||
}</style><g id="shape-83c3baf0-0e37-808a-8008-57cd23a58de0"><defs><clipPath id="frame-clip-83c3baf0-0e37-808a-8008-57cd23a58de0-render-1" class="frame-clip frame-clip-def"><rect rx="6" ry="6" x="0" y="0" width="960.0000381469727" height="77.99999713897705" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-83c3baf0-0e37-808a-8008-57cd23a58de0-render-1)" fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd23a58de0"><rect width="960.0000381469727" height="77.99999713897705" class="frame-background" x="0" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(13, 15, 18); fill-opacity: 1;" ry="6" rx="6" y="0"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57cd23a95d50"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="16" y="14" width="94" height="16" rx="0" ry="0"><defs><pattern patternUnits="objectBoundingBox" width="98.75" height="17.9000244140625" id="fill-0-render-2-0"><g><rect width="98.75" height="17.9000244140625" style="fill: rgb(220, 225, 229); fill-opacity: 1;"/></g></pattern></defs><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd23a95d50"><text x="16" y="31.1500244140625" dominant-baseline="ideographic" textLength="98.75" lengthAdjust="spacingAndGlyphs" style="text-transform: none; font-family: sourcesanspro; letter-spacing: 0px; font-style: normal; font-weight: 700; white-space: pre; font-size: 13px; text-decoration: none; direction: ltr; fill: rgb(220, 225, 229); fill-opacity: 1;">Composition rule</text></g></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cd23b0b044"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="16" y="38" width="927.9999754428864" height="39.999999046325684" rx="0" ry="0"><defs><pattern patternUnits="objectBoundingBox" width="522.6699829101562" height="12.93994140625" id="fill-0-render-3-0"><g><rect width="522.6699829101562" height="12.93994140625" style="fill: rgb(96, 105, 114); fill-opacity: 1;"/></g></pattern></defs><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd23b0b044"><text x="16" y="50.469970703125" dominant-baseline="ideographic" textLength="522.6699829101562" lengthAdjust="spacingAndGlyphs" style="text-transform: none; font-family: sourcesanspro; letter-spacing: 0px; font-style: normal; font-weight: 400; white-space: pre; font-size: 10px; text-decoration: none; direction: ltr; fill: rgb(96, 105, 114); fill-opacity: 1;">Inspector-specific pages should compose these shared headers with domain primitives rather than duplicating their internals.</text></g></g></g></g></g></g><g id="strokes-7b72dd1e-d227-8052-8008-581675f5081c-83c3baf0-0e37-808a-8008-57cd23a58de0" class="strokes"><g class="inner-stroke-shape" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"><defs><clipPath id="inner-stroke-render-1-83c3baf0-0e37-808a-8008-57cd23a58de0-0"><use href="#stroke-shape-render-1-83c3baf0-0e37-808a-8008-57cd23a58de0-0"/></clipPath><rect width="960.0000381469727" height="77.99999713897705" class="frame-background" x="0" id="stroke-shape-render-1-83c3baf0-0e37-808a-8008-57cd23a58de0-0" style="fill: none; stroke-width: 2; stroke: rgb(38, 43, 49); stroke-opacity: 1;" ry="6" rx="6" y="0"/></defs><use href="#stroke-shape-render-1-83c3baf0-0e37-808a-8008-57cd23a58de0-0" clip-path="url('#inner-stroke-render-1-83c3baf0-0e37-808a-8008-57cd23a58de0-0')"/></g></g></g></g></g></svg>
|
||||
|
After Width: | Height: | Size: 4.2 KiB |
@@ -0,0 +1,14 @@
|
||||
<svg width="762" xmlns="http://www.w3.org/2000/svg" height="52" id="screenshot-83c3baf0-0e37-808a-8008-57cd2388f9b9" viewBox="-1 -1 762 52" xmlns:xlink="http://www.w3.org/1999/xlink" fill="none" version="1.1"><style>@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 400;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-regular.woff) format('woff');
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 700;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-bold.woff) format('woff');
|
||||
}</style><g id="shape-83c3baf0-0e37-808a-8008-57cd2388f9b9"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd2388f9b9"><rect width="759.9999904632459" height="49.99999701976776" class="frame-background" x="0" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(9, 11, 13); fill-opacity: 1;" ry="6" rx="6" y="0"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57cd2389565d"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd2389565d"><rect rx="1.4999999664723873" ry="1.4999999664723873" x="7.000001907348405" y="6.999999582767487" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" width="2.9999999329447746" height="35.999999284744206" style="fill: rgb(65, 198, 207); fill-opacity: 1;"/></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cd23893324"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd23893324"><rect rx="0" ry="0" x="18.999958634377663" y="17.99999749277879" width="13.999999761578692" height="13.999999523162046" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57cd23893325" width="16" height="16" rx="0" ry="0" style="fill: rgb(0, 0, 0);"><g id="shape-83c3baf0-0e37-808a-8008-57cd23893326" style="display: none;"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd23893326"><rect width="13.999999761578692" height="13.999999523162046" x="18.999958634377663" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: none;" ry="0" fill="none" rx="0" y="17.99999749277879"/></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cd23893327"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd23893327"><path d="M30.839439392089844,23.714401245117188L26.464561462402344,28.089401245117188C26.341514587402344,28.212875366210938,26.174034118652344,28.282089233398438,25.999717712402344,28.282089233398438C25.824913024902344,28.282089233398438,25.657920837402344,28.212875366210938,25.534873962402344,28.089401245117188L21.159873962402344,23.714401245117188C20.903038024902344,23.457626342773438,20.903038024902344,23.041488647460938,21.159873962402344,22.784713745117188C21.416587829589844,22.527938842773438,21.832725524902344,22.527938842773438,22.089561462402344,22.784713745117188L26.000083923339844,26.695297241210938L29.910606384277344,22.784286499023438C30.167442321777344,22.527084350585938,30.583580017089844,22.527084350585938,30.840415954589844,22.784286499023438C31.097129821777344,23.040634155273438,31.097129821777344,23.456771850585938,30.840415954589844,23.713973999023438Z" style="fill: rgb(155, 163, 171); fill-opacity: 1;"/></g></g></g></g></g></g></g></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cd2389331e"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd2389331e"><rect rx="0" ry="0" x="41.99995863437766" y="15.999997611988078" width="18" height="17.999998688697588" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57cd2389331f" width="16" height="16" rx="0" ry="0" style="fill: rgb(0, 0, 0);"><g id="shape-83c3baf0-0e37-808a-8008-57cd23893320" style="display: none;"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd23893320"><rect width="18" height="17.999998688697588" x="41.99995863437766" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: none;" ry="0" fill="none" rx="0" y="15.999997611988078"/></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cd23893321" rx="0" ry="0" style="fill: rgb(0, 0, 0);"><g id="shape-83c3baf0-0e37-808a-8008-57cd23893322" style="opacity: 0.2;"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd23893322"><path d="M50.999961853027344,25.076583862304688L50.999961853027344,32.31248474121094C50.905479431152344,32.31205749511719,50.812705993652344,32.28788757324219,50.729942321777344,32.24217224121094L44.542442321777344,28.855880737304688C44.362632751464844,28.757431030273438,44.250450134277344,28.568893432617188,44.249961853027344,28.363693237304688L44.249961853027344,21.638961791992188C44.249961853027344,21.559738159179688,44.266685485839844,21.481491088867188,44.299156188964844,21.409103393554688Z" style="fill: rgb(155, 163, 171); fill-opacity: 1;"/></g></g><g id="shape-83c3baf0-0e37-808a-8008-57cd23893323"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57cd23893323"><path d="M57.727500915527344,20.651168823242188L51.540000915527344,17.265609741210938C51.203941345214844,17.079940795898438,50.796104431152344,17.07Line truncated
|
||||
|
After Width: | Height: | Size: 20 KiB |
@@ -0,0 +1,14 @@
|
||||
<svg width="1202" xmlns="http://www.w3.org/2000/svg" height="1972" id="screenshot-6cb78075-fbd0-8045-8008-5801d6740577" viewBox="-1 -1 1202 1972" xmlns:xlink="http://www.w3.org/1999/xlink" fill="none" version="1.1"><style>@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 700;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-bold.woff) format('woff');
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 400;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-regular.woff) format('woff');
|
||||
}</style><g id="shape-6cb78075-fbd0-8045-8008-5801d6740577"><defs><clipPath id="frame-clip-6cb78075-fbd0-8045-8008-5801d6740577-render-1" class="frame-clip frame-clip-def"><rect rx="8" ry="8" x="0" y="0" width="1200" height="1970.0000861847307" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-6cb78075-fbd0-8045-8008-5801d6740577-render-1)" fill="none"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-5801d6740577"><rect width="1200" height="1970.0000861847307" class="frame-background" x="0" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(9, 11, 13); fill-opacity: 1;" ry="8" rx="8" y="0"/></g><g class="frame-children"><g id="shape-6cb78075-fbd0-8045-8008-5801d67a7041"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="24" y="19.999999472114183" width="599.999990285711" height="33.99999892711634" rx="0" ry="0"><defs><pattern patternUnits="objectBoundingBox" width="234.97000122070312" height="33.040000915527344" id="fill-0-render-2-0"><g><rect width="234.97000122070312" height="33.040000915527344" style="fill: rgb(220, 225, 229); fill-opacity: 1;"/></g></pattern></defs><g class="fills" id="fills-6cb78075-fbd0-8045-8008-5801d67a7041"><text x="24" y="51.119999834508235" dominant-baseline="ideographic" textLength="234.97000122070312" lengthAdjust="spacingAndGlyphs" style="text-transform: none; font-family: sourcesanspro; letter-spacing: 0px; font-style: normal; font-weight: 700; white-space: pre; font-size: 24px; text-decoration: none; direction: ltr; fill: rgb(220, 225, 229); fill-opacity: 1;">Blacksite Foundations</text></g></g></g><g id="shape-6cb78075-fbd0-8045-8008-5801d68cc4b4"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="24" y="55.00001622101891" width="1099.999972820282" height="23.999998807907104" rx="0" ry="0"><defs><pattern patternUnits="objectBoundingBox" width="742.2000122070312" height="15.540000915527344" id="fill-0-render-3-0"><g><rect width="742.2000122070312" height="15.540000915527344" style="fill: rgb(155, 163, 171); fill-opacity: 1;"/></g></pattern></defs><g class="fills" id="fills-6cb78075-fbd0-8045-8008-5801d68cc4b4"><text x="24" y="69.57001967093402" dominant-baseline="ideographic" textLength="742.2000122070312" lengthAdjust="spacingAndGlyphs" style="text-transform: none; font-family: sourcesanspro; letter-spacing: 0px; font-style: normal; font-weight: 400; white-space: pre; font-size: 12px; text-decoration: none; direction: ltr; fill: rgb(155, 163, 171); fill-opacity: 1;">Authoritative reusable controls organized by interaction semantics. Use these components instead of rebuilding look-alikes inside feature inspectors.</text></g></g></g><g id="shape-6cb78075-fbd0-8045-8008-5801d69a8ecd"><defs><clipPath id="frame-clip-6cb78075-fbd0-8045-8008-5801d69a8ecd-render-4" class="frame-clip frame-clip-def"><rect rx="6" ry="6" x="24" y="100.00000479038601" width="1152.0000457763672" height="339.9999776194171" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-6cb78075-fbd0-8045-8008-5801d69a8ecd-render-4)" fill="none"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-5801d69a8ecd"><rect width="1152.0000457763672" height="339.9999776194171" class="frame-background" x="24" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(13, 15, 18); fill-opacity: 1;" ry="6" rx="6" y="100.00000479038601"/></g><g class="frame-children"><g id="shape-6cb78075-fbd0-8045-8008-5801d6a00083"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="40" y="114.0000051941552" width="1119.9999895095766" height="18.000000834464885" rx="0" ry="0"><defs><pattern patternUnits="objectBoundingBox" width="59.30999755859375" height="16.520004272460938" id="fill-0-render-5-0"><g><rect width="59.30999755859375" height="16.520004272460938" style="fill: rgb(65, 198, 207); fill-opacity: 1;"/></g></pattern></defs><g class="fills" id="fills-6cb78075-fbd0-8045-8008-5801d6a00083"><text x="40" y="129.06000227591448" dominant-baseline="ideographic" textLength="59.30999755859375" lengthAdjust="spacingAndGlyphs" style="text-transform: none; font-family: sourcesanspro; letter-spacing: 0px; font-style: normal; font-weight: 700; white-space: pre; font-size: 12px; text-decoration: none; direction: ltr; fill: rgb(65, 198, 207); fill-opacity: 1;">SELECTION</text></g></g></g><g id="shape-6cb78075-fbd0-8045-8008-5801d6afb287"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="40" y=Line truncated
|
||||
|
After Width: | Height: | Size: 315 KiB |
@@ -0,0 +1,14 @@
|
||||
<svg width="900" xmlns="http://www.w3.org/2000/svg" height="885" id="screenshot-83c3baf0-0e37-808a-8008-57d8c2a3305d" viewBox="0 0 900 885" xmlns:xlink="http://www.w3.org/1999/xlink" fill="none" version="1.1"><style>@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 400;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-regular.woff) format('woff');
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 700;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-bold.woff) format('woff');
|
||||
}</style><g id="shape-83c3baf0-0e37-808a-8008-57d8c2a3305d"><defs><clipPath id="frame-clip-83c3baf0-0e37-808a-8008-57d8c2a3305d-render-1" class="frame-clip frame-clip-def"><rect rx="6" ry="6" x="0" y="0" width="900" height="885.0002317554662" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-83c3baf0-0e37-808a-8008-57d8c2a3305d-render-1)" fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57d8c2a3305d"><rect width="900" height="885.0002317554662" class="frame-background" x="0" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(7, 8, 10); fill-opacity: 1;" ry="6" rx="6" y="0"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57d8c2c3ca13"><defs><clipPath id="frame-clip-83c3baf0-0e37-808a-8008-57d8c2c3ca13-render-2" class="frame-clip frame-clip-def"><rect rx="0" ry="0" x="24" y="23.99999346879573" width="852.0000457763672" height="71.999999133552" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-83c3baf0-0e37-808a-8008-57d8c2c3ca13-render-2)" fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57d8c2c3ca13"><rect rx="0" ry="0" x="24" y="23.99999346879573" width="852.0000457763672" height="71.999999133552" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57d8c2c95adb"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="24" y="23.99999346879573" width="852.000039682388" height="31.99999988079071" rx="0" ry="0"><defs><pattern patternUnits="objectBoundingBox" width="238.489990234375" height="33.040000915527344" id="fill-0-render-3-0"><g><rect width="238.489990234375" height="33.040000915527344" style="fill: rgb(220, 225, 229); fill-opacity: 1;"/></g></pattern></defs><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57d8c2c95adb"><text x="24" y="55.11999621537776" dominant-baseline="ideographic" textLength="238.489990234375" lengthAdjust="spacingAndGlyphs" style="text-transform: none; font-family: sourcesanspro; letter-spacing: 0px; font-style: normal; font-weight: 700; white-space: pre; font-size: 24px; text-decoration: none; direction: ltr; fill: rgb(220, 225, 229); fill-opacity: 1;">Materials Components</text></g></g></g><g id="shape-83c3baf0-0e37-808a-8008-57d8c2e25ce1"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="24" y="61.99999346879573" width="852.0000352388615" height="34.00000000000001" rx="0" ry="0"><defs><pattern patternUnits="objectBoundingBox" width="598.7899780273438" height="16.839996337890625" id="fill-0-render-4-0"><g><rect width="598.7899780273438" height="16.839996337890625" style="fill: rgb(220, 225, 229); fill-opacity: 1;"/></g></pattern></defs><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57d8c2e25ce1"><text x="24" y="78.61998858598324" dominant-baseline="ideographic" textLength="598.7899780273438" lengthAdjust="spacingAndGlyphs" style="text-transform: none; font-family: sourcesanspro; letter-spacing: 0px; font-style: normal; font-weight: 400; white-space: pre; font-size: 13px; text-decoration: none; direction: ltr; fill: rgb(220, 225, 229); fill-opacity: 1;">Authoritative material editor components shared by the Materials inspector and mesh material-slot workflows.</text></g></g></g></g></g></g></g></g></g><g id="shape-83c3baf0-0e37-808a-8008-57d8c2f4bddc"><defs><clipPath id="frame-clip-83c3baf0-0e37-808a-8008-57d8c2f4bddc-render-5" class="frame-clip frame-clip-def"><rect rx="0" ry="0" x="24" y="115.99998309758755" width="852.0000457763672" height="47.00000081926771" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-83c3baf0-0e37-808a-8008-57d8c2f4bddc-render-5)" fill="none"><g class="fills" id="fills-83c3baf0-0e37-808a-8008-57d8c2f4bddc"><rect rx="0" ry="0" x="24" y="115.99998309758755" width="852.0000457763672" height="47.00000081926771" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-83c3baf0-0e37-808a-8008-57d8c2fa4ff0"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="24" y="115.99999346879574" width="852.0000589799888" height="16.000000596046448" rx="0" ry="0"><defs><pattern patternUnits="objectBoundingBox" width="135.39999389648438" height="15.139999389648438" id="fillLine truncated
|
||||
|
After Width: | Height: | Size: 262 KiB |
@@ -0,0 +1,14 @@
|
||||
<svg width="422" xmlns="http://www.w3.org/2000/svg" height="857" id="screenshot-ad983554-05bb-80cb-8008-5698e08d425a" viewBox="-1 -1 422 857" xmlns:xlink="http://www.w3.org/1999/xlink" fill="none" version="1.1"><style>@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 400;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-regular.woff) format('woff');
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 700;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-bold.woff) format('woff');
|
||||
}</style><g id="shape-ad983554-05bb-80cb-8008-5698e08d425a"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-ad983554-05bb-80cb-8008-5698e08d425a"><rect width="420.000018176607" height="855.0001047784708" class="frame-background" x="0" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(13, 15, 18); fill-opacity: 1;" ry="7" rx="7" y="0"/></g><g class="frame-children"><g id="shape-ad983554-05bb-80cb-8008-5698e08f8cb1"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-ad983554-05bb-80cb-8008-5698e08f8cb1"><rect rx="0" ry="0" x="12.000047344043878" y="9.999898829513427" width="396.000057912451" height="32" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-ad983554-05bb-80cb-8008-5698e08f8cb2"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="11.996072777794552" y="17.499898829513427" width="58.000006672897825" height="17" rx="0" ry="0"><defs><pattern patternUnits="objectBoundingBox" width="57.71002197265625" height="19.279998779296875" id="fill-0-render-3-0"><g><rect width="57.71002197265625" height="19.279998779296875" style="fill: rgb(220, 225, 229); fill-opacity: 1;"/></g></pattern></defs><g class="fills" id="fills-ad983554-05bb-80cb-8008-5698e08f8cb2"><text x="11.996060388826209" y="35.739901481474135" dominant-baseline="ideographic" textLength="57.71002197265625" lengthAdjust="spacingAndGlyphs" style="text-transform: none; font-family: sourcesanspro; letter-spacing: 0px; font-style: normal; font-weight: 700; white-space: pre; font-size: 14px; text-decoration: none; direction: ltr; fill: rgb(220, 225, 229); fill-opacity: 1;">Materials</text></g></g></g></g></g></g></g></g></g><g id="shape-ad983554-05bb-80cb-8008-5698e08d4266"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-ad983554-05bb-80cb-8008-5698e08d4266"><rect rx="0" ry="0" x="12.000047344043878" y="49.993872633481715" width="396.000057912451" height="0.01" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-6cb78075-fbd0-8045-8008-57faf1d388da"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57faf1d388da"><rect width="396.0000623794065" height="683.0003647114545" class="frame-background" x="12.000004308947155" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(9, 11, 13); fill-opacity: 1;" ry="6" rx="6" y="50.191940344935006"/></g><g class="frame-children"><g id="shape-6cb78075-fbd0-8045-8008-57faf1d64366"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57faf1d64366"><rect width="396.0000737378846" height="82.00000977516163" class="frame-background" x="11.999845286589789" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(9, 11, 13); fill-opacity: 1;" ry="5" rx="5" y="50.19194052596839"/></g><g class="frame-children"><g id="shape-6cb78075-fbd0-8045-8008-57faf1d7269c"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57faf1d7269c"><rect rx="1.5000001788139343" ry="1.5000001788139343" x="19.999765267081898" y="58.19188926597337" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" width="3.0000003576278687" height="65.99995279312145" style="fill: rgb(65, 198, 207); fill-opacity: 1;"/></g></g><g id="shape-6cb78075-fbd0-8045-8008-57faf1d72698"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57faf1d72698"><rect rx="0" ry="0" x="28.999766339965504" y="85.19186995406841" width="12.000001430511475" height="11.999991416931152" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-6cb78075-fbd0-8045-8008-57faf1d72699" width="16" height="16" rx="0" ry="0" style="fill: rgb(0, 0, 0);"><g id="shape-6cb78075-fbd0-8045-8008-57faf1d7269a" style="display: none;"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57faf1d7269a"><rect width="12.000001430511475" height="11.999991416931152" x="28.999766339965504" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: none;" ry="0" fill="none" rx="0" y="85.19186995406841"/></g></g><g id="shape-6cb78075-fbd0-8045-8008-57faf1d7269b"><g class="fills" id="fiLine truncated
|
||||
|
After Width: | Height: | Size: 255 KiB |
@@ -0,0 +1,14 @@
|
||||
<svg width="622" xmlns="http://www.w3.org/2000/svg" height="661" id="screenshot-ad983554-05bb-80cb-8008-5698dfab667e" viewBox="-1 -1 622 661" xmlns:xlink="http://www.w3.org/1999/xlink" fill="none" version="1.1"><style>@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 400;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-regular.woff) format('woff');
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 700;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-bold.woff) format('woff');
|
||||
}</style><g id="shape-ad983554-05bb-80cb-8008-5698dfab667e"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-ad983554-05bb-80cb-8008-5698dfab667e"><rect width="619.9999904632568" height="659.0000018974088" class="frame-background" x="0" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(13, 15, 18); fill-opacity: 1;" ry="7" rx="7" y="0"/></g><g class="frame-children"><g id="shape-ad983554-05bb-80cb-8008-5698dfad2c1c"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-ad983554-05bb-80cb-8008-5698dfad2c1c"><rect rx="0" ry="0" x="12.000000843743692" y="9.999995897250187" width="596.0000114440918" height="32" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-ad983554-05bb-80cb-8008-5698dfad2c1d"><g transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="text-container" x="12.000002516771502" y="17.499995897250187" width="57.99999570846526" height="17" rx="0" ry="0"><defs><pattern patternUnits="objectBoundingBox" width="57.709991455078125" height="19.279998779296875" id="fill-0-render-3-0"><g><rect width="57.709991455078125" height="19.279998779296875" style="fill: rgb(220, 225, 229); fill-opacity: 1;"/></g></pattern></defs><g class="fills" id="fills-ad983554-05bb-80cb-8008-5698dfad2c1d"><text x="12.000001975398959" y="35.74000735085451" dominant-baseline="ideographic" textLength="57.709991455078125" lengthAdjust="spacingAndGlyphs" style="text-transform: none; font-family: sourcesanspro; letter-spacing: 0px; font-style: normal; font-weight: 700; white-space: pre; font-size: 14px; text-decoration: none; direction: ltr; fill: rgb(220, 225, 229); fill-opacity: 1;">Materials</text></g></g></g></g></g></g></g></g></g><g id="shape-ad983554-05bb-80cb-8008-5698dfaba638"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-ad983554-05bb-80cb-8008-5698dfaba638"><rect rx="0" ry="0" x="12.000000843743692" y="50.57079842377448" width="596.0000114440918" height="0.01" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-6cb78075-fbd0-8045-8008-57faf04a4a27"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57faf04a4a27"><rect width="596.0000251546381" height="487.0001518031392" class="frame-background" x="12.000001975398959" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(9, 11, 13); fill-opacity: 1;" ry="6" rx="6" y="50.253124699629836"/></g><g class="frame-children"><g id="shape-6cb78075-fbd0-8045-8008-57faf04d936d"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57faf04d936d"><rect width="595.9999712009691" height="82.00000977516163" class="frame-background" x="11.999830159348676" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(9, 11, 13); fill-opacity: 1;" ry="5" rx="5" y="50.25313043858415"/></g><g class="frame-children"><g id="shape-6cb78075-fbd0-8045-8008-57faf04e7869"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57faf04e7869"><rect rx="1.5" ry="1.5" x="19.9998289754206" y="58.25307917858913" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" width="3" height="65.99995279312145" style="fill: rgb(65, 198, 207); fill-opacity: 1;"/></g></g><g id="shape-6cb78075-fbd0-8045-8008-57faf04e7865"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57faf04e7865"><rect rx="0" ry="0" x="28.9998289754206" y="85.25305986668417" width="12" height="11.999991416931152" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-6cb78075-fbd0-8045-8008-57faf04e7866" width="16" height="16" rx="0" ry="0" style="fill: rgb(0, 0, 0);"><g id="shape-6cb78075-fbd0-8045-8008-57faf04e7867" style="display: none;"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57faf04e7867"><rect width="12" height="11.999991416931152" x="28.9998289754206" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: none;" ry="0" fill="none" rx="0" y="85.25305986668417"/></g></g><g id="shape-6cb78075-fbd0-8045-8008-57faf04e7868"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57faf04e7868"><path d="M39.14786148071289,90.151107788Line truncated
|
||||
|
After Width: | Height: | Size: 253 KiB |
@@ -0,0 +1,14 @@
|
||||
<svg width="480" xmlns="http://www.w3.org/2000/svg" height="828" id="screenshot-6cb78075-fbd0-8045-8008-57f5419afad2" viewBox="0 0 480 828" xmlns:xlink="http://www.w3.org/1999/xlink" fill="none" version="1.1"><style>@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 700;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-bold.woff) format('woff');
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 400;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-regular.woff) format('woff');
|
||||
}</style><g id="shape-6cb78075-fbd0-8045-8008-57f5419afad2"><defs><clipPath id="frame-clip-6cb78075-fbd0-8045-8008-57f5419afad2-render-1" class="frame-clip frame-clip-def"><rect rx="4" ry="4" x="0" y="0" width="480.00002020283694" height="827.9998016063415" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-6cb78075-fbd0-8045-8008-57f5419afad2-render-1)" fill="none"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57f5419afad2"><rect width="480.00002020283694" height="827.9998016063415" class="frame-background" x="0" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(9, 11, 13); fill-opacity: 1;" ry="4" rx="4" y="0"/></g><g class="frame-children"><g id="shape-6cb78075-fbd0-8045-8008-57f541a7f8a1"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57f541a7f8a1"><rect width="480.00002176754856" height="50" class="frame-background" x="-9.230917612512712e-7" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(9, 11, 13); fill-opacity: 1;" ry="6" rx="6" y="11.999990888686654"/></g><g class="frame-children"><g id="shape-6cb78075-fbd0-8045-8008-57f541a86dc0"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57f541a86dc0"><rect rx="1.4999999664723873" ry="1.4999999664723873" x="7.000001102333272" y="18.999993546046795" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" width="2.9999999329447746" height="35.999988555908374" style="fill: rgb(65, 198, 207); fill-opacity: 1;"/></g></g><g id="shape-6cb78075-fbd0-8045-8008-57f541a83cd6"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57f541a83cd6"><rect rx="0" ry="0" x="19.000007420426982" y="30.000003436592323" width="13.999999761578692" height="13.999995350837082" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-6cb78075-fbd0-8045-8008-57f541a83cd7" width="16" height="16" rx="0" ry="0" style="fill: rgb(0, 0, 0);"><g id="shape-6cb78075-fbd0-8045-8008-57f541a83cd8" style="display: none;"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57f541a83cd8"><rect width="13.999999761578692" height="13.999995350837082" x="19.000007420426982" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: none;" ry="0" fill="none" rx="0" y="30.000003436592323"/></g></g><g id="shape-6cb78075-fbd0-8045-8008-57f541a83cd9"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57f541a83cd9"><path d="M30.83950424194336,35.71439743041992L26.46462631225586,40.08939743041992C26.34157943725586,40.21287155151367,26.17409896850586,40.28208541870117,25.99978256225586,40.28208541870117C25.82497787475586,40.28208541870117,25.65798568725586,40.21287155151367,25.53493881225586,40.08939743041992L21.15993881225586,35.71439743041992C20.90310287475586,35.45762252807617,20.90310287475586,35.04148483276367,21.15993881225586,34.78470993041992C21.41665267944336,34.52793502807617,21.83279037475586,34.52793502807617,22.08962631225586,34.78470993041992L26.00014877319336,38.69529342651367L29.91067123413086,34.78428268432617C30.16750717163086,34.52708053588867,30.58364486694336,34.52708053588867,30.84048080444336,34.78428268432617C31.09719467163086,35.04063034057617,31.09719467163086,35.45676803588867,30.84048080444336,35.71397018432617Z" style="fill: rgb(155, 163, 171); fill-opacity: 1;"/></g></g></g></g></g></g></g></g></g><g id="shape-6cb78075-fbd0-8045-8008-57f541a83cd0"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57f541a83cd0"><rect rx="0" ry="0" x="42.0000188570682" y="28.00000415184803" width="18" height="17.999993324279927" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-6cb78075-fbd0-8045-8008-57f541a83cd1" width="16" height="16" rx="0" ry="0" style="fill: rgb(0, 0, 0);"><g id="shape-6cb78075-fbd0-8045-8008-57f541a83cd2" style="display: none;"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57f541a83cd2"><rect width="18" height="17.999993324279927" x="42.0000188570682" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: none;" ry="0" fill="none" rx="0" y="28.00000415184803"/></g></g><g id="shape-6cb78075-fbd0-8045-8008-57f541a83cd3" rx="0" ry="0" style="fill: rgb(0, 0, 0);"><g id="shape-6cb78075-fbd0-8045-8008-57f541a83cd4" style="opacity: 0.2;"><g class="fills" id="fills-6cb78075-fbd0-80Line truncated
|
||||
|
After Width: | Height: | Size: 513 KiB |
@@ -0,0 +1,14 @@
|
||||
<svg width="760" xmlns="http://www.w3.org/2000/svg" height="1233" id="screenshot-6cb78075-fbd0-8045-8008-57f5315abf0a" viewBox="0 0 760 1233" xmlns:xlink="http://www.w3.org/1999/xlink" fill="none" version="1.1"><style>@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 700;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-bold.woff) format('woff');
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'sourcesanspro';
|
||||
font-style: normal;
|
||||
font-weight: 400;
|
||||
font-display: block;
|
||||
src: url(https://penpot.spacetrainclubhouse.com/fonts/sourcesanspro-regular.woff) format('woff');
|
||||
}</style><g id="shape-6cb78075-fbd0-8045-8008-57f5315abf0a"><defs><clipPath id="frame-clip-6cb78075-fbd0-8045-8008-57f5315abf0a-render-1" class="frame-clip frame-clip-def"><rect rx="4" ry="4" x="0" y="0" width="759.999986665522" height="1233.0001399293162" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)"/></clipPath></defs><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g clip-path="url(#frame-clip-6cb78075-fbd0-8045-8008-57f5315abf0a-render-1)" fill="none"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57f5315abf0a"><rect width="759.999986665522" height="1233.0001399293162" class="frame-background" x="0" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(9, 11, 13); fill-opacity: 1;" ry="4" rx="4" y="0"/></g><g class="frame-children"><g id="shape-6cb78075-fbd0-8045-8008-57f53167a903"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57f53167a903"><rect width="760.0001096635713" height="50" class="frame-background" x="0.0000012750645055348286" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: rgb(9, 11, 13); fill-opacity: 1;" ry="6" rx="6" y="11.999988420057207"/></g><g class="frame-children"><g id="shape-6cb78075-fbd0-8045-8008-57f5316838ef"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57f5316838ef"><rect rx="1.4999999664723873" ry="1.4999999664723873" x="7.000012546425069" y="18.99999455932607" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" width="2.9999999329447746" height="35.999988555908374" style="fill: rgb(65, 198, 207); fill-opacity: 1;"/></g></g><g id="shape-6cb78075-fbd0-8045-8008-57f5316838eb"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57f5316838eb"><rect rx="0" ry="0" x="18.999954014665263" y="29.999989191082534" width="13.999999761578692" height="13.999995350837082" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-6cb78075-fbd0-8045-8008-57f5316838ec" width="16" height="16" rx="0" ry="0" style="fill: rgb(0, 0, 0);"><g id="shape-6cb78075-fbd0-8045-8008-57f5316838ed" style="display: none;"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57f5316838ed"><rect width="13.999999761578692" height="13.999995350837082" x="18.999954014665263" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: none;" ry="0" fill="none" rx="0" y="29.999989191082534"/></g></g><g id="shape-6cb78075-fbd0-8045-8008-57f5316838ee"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57f5316838ee"><path d="M30.839431762695312,35.714385986328125L26.46454620361328,40.089385986328125C26.34149932861328,40.212860107421875,26.17401885986328,40.282073974609375,25.99970245361328,40.282073974609375C25.82489776611328,40.282073974609375,25.65790557861328,40.212860107421875,25.53485870361328,40.089385986328125L21.15985870361328,35.714385986328125C20.90302276611328,35.457611083984375,20.90302276611328,35.041473388671875,21.15985870361328,34.784698486328125C21.41657257080078,34.527923583984375,21.83271026611328,34.527923583984375,22.08954620361328,34.784698486328125L26.00006866455078,38.695281982421875L29.910598754882812,34.784271240234375C30.167434692382812,34.527069091796875,30.583572387695312,34.527069091796875,30.840408325195312,34.784271240234375C31.097122192382812,35.040618896484375,31.097122192382812,35.456756591796875,30.840408325195312,35.713958740234375Z" style="fill: rgb(155, 163, 171); fill-opacity: 1;"/></g></g></g></g></g></g></g></g></g><g id="shape-6cb78075-fbd0-8045-8008-57f5316838e5"><g class="frame-container-wrapper"><g class="frame-container-blur"><g class="frame-container-shadows"><g fill="none"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57f5316838e5"><rect rx="0" ry="0" x="41.99996545130648" y="27.999989906338243" width="18" height="17.999993324279927" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" class="frame-background"/></g><g class="frame-children"><g id="shape-6cb78075-fbd0-8045-8008-57f5316838e6" width="16" height="16" rx="0" ry="0" style="fill: rgb(0, 0, 0);"><g id="shape-6cb78075-fbd0-8045-8008-57f5316838e7" style="display: none;"><g class="fills" id="fills-6cb78075-fbd0-8045-8008-57f5316838e7"><rect width="18" height="17.999993324279927" x="41.99996545130648" transform="matrix(1.000000, 0.000000, 0.000000, 1.000000, 0.000000, 0.000000)" style="fill: none;" ry="0" fill="none" rx="0" y="27.999989906338243"/></g></g><g id="shape-6cb78075-fbd0-8045-8008-57f5316838e8" rx="0" ry="0" style="fill: rgb(0, 0, 0);"><g id="shape-6cb78075-fbd0-8045-8008-57f5316838e9" style="opacity: 0.2;"><g class=Line truncated
|
||||
|
After Width: | Height: | Size: 513 KiB |
@@ -1,5 +1,7 @@
|
||||
# Deterministic Imported-Asset Fingerprints Evaluation
|
||||
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../README.md) for current behavior and architecture.
|
||||
|
||||
**Date:** 2026-07-13
|
||||
|
||||
**Issue:** [Gitea #56](https://git.spacetrainclubhouse.com/Falling-Metal-Interactive/Blacksite/issues/56)
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# FBX External Texture Dependency Evaluation
|
||||
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../README.md) for current behavior and architecture.
|
||||
|
||||
**Date:** 2026-07-13
|
||||
|
||||
**Issue:** [Gitea #58](https://git.spacetrainclubhouse.com/Falling-Metal-Interactive/Blacksite/issues/58)
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Guarded Shutdown And Clean Savepoints Evaluation
|
||||
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../README.md) for current behavior and architecture.
|
||||
|
||||
**Date:** 2026-07-13
|
||||
|
||||
**Issue:** [Gitea #55](https://git.spacetrainclubhouse.com/Falling-Metal-Interactive/Blacksite/issues/55)
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# H1 Gate Sign-Off — Game Development Ready
|
||||
|
||||
> Historical baseline only. Current production authority: [production-readiness matrix](production-readiness/).
|
||||
> **Historical record — not current implementation guidance.** Current production authority: [production-readiness matrix](production-readiness/README.md).
|
||||
|
||||
**Date:** 2026-05-30
|
||||
**Evaluator:** implementation pass
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# H2 Gate Sign-Off — Content Pipeline Maturity
|
||||
|
||||
> Historical baseline only. Current production authority: [production-readiness matrix](production-readiness/).
|
||||
> **Historical record — not current implementation guidance.** Current production authority: [production-readiness matrix](production-readiness/README.md).
|
||||
|
||||
**Date:** 2026-05-30
|
||||
**Result:** Pass with waivers
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# H3 Gate Sign-Off — Gameplay Authoring
|
||||
|
||||
> Historical baseline only. Current production authority: [production-readiness matrix](production-readiness/).
|
||||
> **Historical record — not current implementation guidance.** Current production authority: [production-readiness matrix](production-readiness/README.md).
|
||||
|
||||
**Date:** 2026-05-30
|
||||
**Result:** Pass
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# H4 Gate Sign-Off — Multiplayer Tooling
|
||||
|
||||
> Historical baseline only. Current production authority: [production-readiness matrix](production-readiness/).
|
||||
> **Historical record — not current implementation guidance.** Current production authority: [production-readiness matrix](production-readiness/README.md).
|
||||
|
||||
**Date:** 2026-05-30
|
||||
**Result:** Pass with waivers
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# H5 Gate Sign-Off — Extensibility
|
||||
|
||||
> Historical baseline only. Current production authority: [production-readiness matrix](production-readiness/).
|
||||
> **Historical record — not current implementation guidance.** Current production authority: [production-readiness matrix](production-readiness/README.md).
|
||||
|
||||
**Date:** 2026-05-30
|
||||
**Result:** Pass
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# H6 Gate Sign-Off — Production / Framework 1.0
|
||||
|
||||
> Historical baseline only. Current production authority: [production-readiness matrix](production-readiness/).
|
||||
> **Historical record — not current implementation guidance.** Current production authority: [production-readiness matrix](production-readiness/README.md).
|
||||
|
||||
**Date:** 2026-05-30
|
||||
**Result:** Pass with waivers
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Material Library And Targeted Drop Evaluation
|
||||
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../README.md) for current behavior and architecture.
|
||||
|
||||
Date: 2026-07-12
|
||||
Branch: `codex/material-library-targeted-drop`
|
||||
Implementation commit: `02247f0`
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Renderer, Material, and Component Foundation Evaluation
|
||||
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../README.md) for current behavior and architecture.
|
||||
|
||||
Date: 2026-07-11
|
||||
Branch: `codex/renderer-material-component-foundation`
|
||||
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Native Dialog Responsiveness Evaluation
|
||||
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../README.md) for current behavior and architecture.
|
||||
|
||||
Date: 2026-07-12
|
||||
Branch: `codex/non-blocking-native-dialogs`
|
||||
Implementation commits: `d038cf3` and the closing commit for Gitea #52
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Navigation Authoring Evaluation
|
||||
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../README.md) for current behavior and architecture.
|
||||
|
||||
Date: 2026-07-12
|
||||
Branch: `codex/renderer-material-component-foundation`
|
||||
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Operator Invariants Evaluation
|
||||
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../README.md) for current behavior and architecture.
|
||||
|
||||
Date: 2026-07-12
|
||||
|
||||
Gitea issue:
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Physics Placement Evaluation
|
||||
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../README.md) for current behavior and architecture.
|
||||
|
||||
Date: 2026-07-12
|
||||
|
||||

|
||||
|
||||
@@ -1,8 +1,10 @@
|
||||
# Production-Readiness Acceptance Matrix
|
||||
|
||||
**Matrix version:** 0.7
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../README.md) for current behavior and architecture.
|
||||
|
||||
**Last audit:** 2026-07-13
|
||||
**Matrix version:** 0.8
|
||||
|
||||
**Last audit:** 2026-07-14
|
||||
|
||||
**Release-candidate commit:** Not nominated
|
||||
|
||||
@@ -35,15 +37,15 @@ another commit, a dirty worktree, or an older package do not transfer to the can
|
||||
| G3 | Undo/redo/cancel invariants and helper cleanup cover every production mutation path | Partial | Source implementation and focused evidence are complete in [operator regression testing](../../operator-regression-testing.md) and the [operator-invariants evaluation](../operator-invariants/); Gitea `#33` closed at `c55f347`. A clean, exact-candidate rerun is still required for `Pass`. |
|
||||
| G4 | Representative project completes an eight-hour soak without unbounded memory/target growth or unrecoverable failure | Missing | No candidate soak log, resource timeline, failure ledger, or target-growth measurement exists. |
|
||||
| G5 | Cold start, scene open/save, asset refresh, common manipulation, and package-build budgets are documented and measured | Missing | Gitea `#34` is open; no ratified budgets or candidate measurement record exists. |
|
||||
| G6 | Headless content validation and CI are green from a clean checkout | Missing | [CI configuration](../../../../.github/workflows/ci.yml) hydrates LFS, runs both project/sample content gates, and asserts a pristine checkout. The [#56 feature run](../deterministic-asset-fingerprints/) passed native startup and both validators from a fresh LFS-hydrated worktree at `cbd380a`; [#58](../fbx-external-texture-dependencies/) passed both validators and clean native startup at `3e30c61`. No release candidate is nominated and no candidate CI run is linked. The current Gitea server does not expose an Actions run endpoint for this repository. |
|
||||
| G6 | Headless content validation and CI are green from a clean checkout | Missing | [CI configuration](../../../../.github/workflows/ci.yml) hydrates LFS, runs both project/sample content gates, and asserts a pristine checkout. The [#56 feature run](../deterministic-asset-fingerprints/) passed native startup and both validators from a fresh LFS-hydrated worktree at `cbd380a`; [#58](../fbx-external-texture-dependencies/) passed both validators and clean native startup at `3e30c61`. The local M2 content-workspace run passed `process-assets --check`, both validators, full all-feature tests, and strict all-feature lint over 48 assets, but its dirty worktree is not candidate evidence. No release candidate is nominated and no candidate CI run is linked. The current Gitea server does not expose an Actions run endpoint for this repository. |
|
||||
| G7 | First-hour UX and recovery QA are signed off by someone other than the implementer | External | No independent sign-off exists. Gitea `#36` remains open; historical H1-H6 implementation-pass notes do not count. |
|
||||
| G8 | Known limitations have severity/workaround and no P0 blocker remains | Partial | Sample-pack gap `#32`, guarded shutdown/savepoints `#55`, scoped UI action safety `#57`, deterministic imported-asset fingerprints `#56`, and external FBX dependency handling `#58` have complete feature-level acceptance; no known P0 implementation blocker remains. A consolidated candidate limitations ledger and exact-candidate rerun are still missing. Property-block application `#53` remains P1; dynamic deformed Solari geometry `#54` is a documented P2 limitation with Forward/raster fallback. |
|
||||
| G8 | Known limitations have severity/workaround and no P0 blocker remains | Partial | Sample-pack gap `#32`, guarded shutdown/savepoints `#55`, scoped UI action safety `#57`, deterministic imported-asset fingerprints `#56`, external FBX dependency handling `#58`, and property-block application/promotion `#53` have complete feature-level implementations; no known P0 implementation blocker remains. A consolidated candidate limitations ledger and exact-candidate rerun are still missing. Dynamic deformed Solari geometry `#54` is a documented P2 limitation with Forward/raster fallback. |
|
||||
|
||||
## Deliverables
|
||||
|
||||
| ID | Deliverable | State | Evidence or next action |
|
||||
|----|-------------|-------|-------------------------|
|
||||
| D1 | Versioned acceptance matrix under `docs/editor/evaluations/` | Pass | This file, version 0.6. |
|
||||
| D1 | Versioned acceptance matrix under `docs/editor/evaluations/` | Pass | This file, version 0.8. |
|
||||
| D2 | Release-candidate representative project and reproducible validation commands | Partial | The committed [sample regression pack](../sample-regression-pack/), commands, exact-implementation native evidence, and [fresh-checkout fingerprint protocol](../deterministic-asset-fingerprints/) exist. Nominate a release candidate and rerun the complete set from a clean LFS-hydrated checkout. |
|
||||
| D3 | Signed milestone comment linking evidence, limitations, and exact commit | Missing | Post only after G1-G8 pass; no candidate exists yet. |
|
||||
|
||||
@@ -57,7 +59,7 @@ another commit, a dirty worktree, or an older package do not transfer to the can
|
||||
| Multi-scene composition | Implemented | Not rerun |
|
||||
| Five-area editor sample pack | Implemented with manifest, native menu, typed scene gate, and headless validation | Exact-implementation source/native acceptance passed at `d52cc2e`; not rerun as one release candidate |
|
||||
| Brush blockout/edit/CSG | Implemented foundation; `#37` open | Not signed off |
|
||||
| Material catalog and assignment | Renderer/material foundation `#51`, Material Library, and exact targeted drops accepted; optional property-block promotion is `#53` | Not rerun as one candidate |
|
||||
| Material catalog and assignment | Renderer/material foundation `#51`, Material Library, exact targeted drops, and MaterialPropertyBlock application/promotion `#53` are implemented | Not rerun as one candidate |
|
||||
| Rendering volumes and look development | Deterministic visible rendering fixture is in the sample pack | Not rerun as one candidate |
|
||||
| Terrain authoring | `#22`-`#24` source/live acceptance complete; M3 closed | Feature-level live acceptance exists; not rerun as one candidate. Packaged-runtime acceptance owner-deferred. |
|
||||
| Physics placement | `#25` source/live acceptance complete | Feature-level live acceptance exists; not rerun as one candidate. Packaged-runtime acceptance owner-deferred. |
|
||||
@@ -73,6 +75,7 @@ another commit, a dirty worktree, or an older package do not transfer to the can
|
||||
| Scoped UI action safety | Implemented; `#57` source validation, six focused regressions, selection precedence, and native toolbar/Inspector/diagnostics workflows passed at `9e23ae7` | Feature-level acceptance complete; not rerun as one candidate |
|
||||
| Imported asset identity and generated artifacts | Implemented; `#56` uses shared BLAKE3 fingerprints, byte-preserving semantic publication, and normalized registry order | Fresh LFS checkout, native startup, mtime-only drift, validators, and artifact hashes passed at `cbd380a`; not rerun as one candidate |
|
||||
| FBX external texture dependencies | Implemented; `#58` uses one sandboxed resolver, transactional bundle import, labeled loader images, authoritative manifests, and explicit Source Materials/Authoring Override semantics | Sibling/`.fbm`/missing/traversal/symlink tests, both validators, exact-implementation native chair QA, and a controlled broken fixture passed at `3e30c61`; not rerun as one candidate |
|
||||
| Content workspace and import authoring | Registry v3, shared content pipeline, managed-path hiding, reviewed destination-first Import Here/Import To, file-manager multi-selection/context actions, transactional extract-and-map model defaults, stable-ID move/copy semantics, derived-aware Trash/restore, DefaultGrid, and reviewed exact-slot property-block promotion are implemented locally | [M2 native evaluation](../content-workspace-m2/) records the Poly Haven import/extraction, reimport orphan Locate/Clear, reference-safe folder move, fresh-ID Duplicate, guarded duplicate undo including generated manifests, Forward/Solari fallback, deterministic 48-asset headless processing, and a packaged DefaultGrid launch through 2026-07-14. Focused tests cover Import To/final-path review and transactional property-block promotion. Full all-feature tests/lint and validators pass with zero blockers. Exact committed-candidate rerun, clean-worktree assertion, Gitea attachments, and independent signoff remain pending. |
|
||||
|
||||
## Candidate Validation Commands
|
||||
|
||||
@@ -88,6 +91,7 @@ cargo clippy -p editor -p game --bins --features dev,hot-reload -- -D warnings
|
||||
cargo test --workspace
|
||||
cargo validate-levels --project .
|
||||
cargo validate-samples --project .
|
||||
cargo process-assets --project . --check --json
|
||||
cargo bake-navigation --project . --check
|
||||
```
|
||||
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Sample Regression Pack Evaluation
|
||||
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../README.md) for current behavior and architecture.
|
||||
|
||||
**Date:** 2026-07-13
|
||||
|
||||
**Issue:** [Gitea #32](https://git.spacetrainclubhouse.com/Falling-Metal-Interactive/Blacksite/issues/32)
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Scoped UI Action Safety Evaluation
|
||||
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../README.md) for current behavior and architecture.
|
||||
|
||||
**Date:** 2026-07-13
|
||||
|
||||
**Issue:** [Gitea #57](https://git.spacetrainclubhouse.com/Falling-Metal-Interactive/Blacksite/issues/57)
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Terrain Foundation Evaluation
|
||||
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../README.md) for current behavior and architecture.
|
||||
|
||||
Date: 2026-07-12
|
||||
Branch: `codex/terrain-foundation`
|
||||
Gitea issue: `#22`
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Terrain Material Layers Acceptance
|
||||
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../README.md) for current behavior and architecture.
|
||||
|
||||
## Evidence
|
||||
|
||||

|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Terrain Sculpt Tools Acceptance
|
||||
|
||||
> **Evidence record — not current product guidance.** Use the [documentation index](../../../README.md) for current behavior and architecture.
|
||||
|
||||
Issue: Gitea `#23`
|
||||
|
||||
Scope: native Wayland debug editor; packaged acceptance remains deferred by project-owner direction.
|
||||
|
||||
@@ -1,28 +1,65 @@
|
||||
# Material System
|
||||
|
||||
Blacksite uses shared project materials and renderer-owned material slots. Static and skinned mesh
|
||||
renderers expose the same assignment workflow, but remain separate components with separate mesh
|
||||
and hydration ownership. The permanent contracts are [ADR 0035](../adr/0035-shared-material-assets-and-renderer-slots.md)
|
||||
and [ADR 0036](../adr/0036-surface-abi-and-solari-parity.md).
|
||||
Blacksite uses shared project materials and renderable-owned material slots. Primitives, static
|
||||
meshes, and skinned meshes expose the same assignment workflow, but retain separate geometry and
|
||||
hydration ownership. The permanent contracts are [ADR 0035](../adr/0035-shared-material-assets-and-renderer-slots.md),
|
||||
[ADR 0036](../adr/0036-surface-abi-and-solari-parity.md),
|
||||
[ADR 0046](../adr/0046-schema-driven-material-inputs-and-processed-textures.md), and
|
||||
[ADR 0047](../adr/0047-editor-authored-asset-documents.md). Material authoring presentation follows
|
||||
the shared [editor design system](design-system.md) and
|
||||
[ADR 0049](../adr/0049-penpot-led-editor-visual-system.md).
|
||||
|
||||
## Mental model
|
||||
|
||||
| Concept | Owns | Saved? |
|
||||
|---------|------|--------|
|
||||
| Material asset | Reusable shader choice, render state, parameters, and textures | Yes, under `assets/materials/` |
|
||||
| Material instance | Overrides over one direct base material | Yes, under `assets/materials/` |
|
||||
| Renderer material slot | A stable reference on one static or skinned renderer | Yes, in scenes/prefabs |
|
||||
| Material asset | Reusable shader choice, render state, parameters, and textures | Yes, anywhere under `assets/` |
|
||||
| Material instance | Overrides over one direct base material | Yes, anywhere under `assets/` |
|
||||
| Material slot assignment | Only the actor/prefab override for a stable primitive or renderer slot | Yes, in scenes/prefabs |
|
||||
| Imported source material | Read-only default supplied by model import | Yes, as the slot fallback |
|
||||
| Material property block | Reserved runtime-only per-renderer/per-slot override schema; application/promotion tracked by Gitea #53 | No |
|
||||
| Model material selection | Source, project Material/Instance, or Default for one stable imported slot | Yes, in registry import metadata |
|
||||
| Property block | Per-owner/per-slot runtime parameter and texture overrides | No |
|
||||
| DefaultGrid | Immutable engine fallback for missing or unassigned surfaces | Engine built-in |
|
||||
|
||||
A renderer slot stores a `MaterialRef`, not a copy of the material. The registry UUID and subasset
|
||||
A material slot assignment stores a `MaterialRef`, not a copy of the material. Model defaults and
|
||||
imported source selections stay asset-owned in import metadata and runtime manifests instead of
|
||||
being copied into actor overrides. Every primitive has one stable
|
||||
`slot:primitive:surface`; mesh renderers use imported stable slot IDs. The registry UUID and subasset
|
||||
ID identify the target; the cached path is only a loading hint. A material instance may reference a
|
||||
material, but may not reference another instance.
|
||||
|
||||
`MaterialPropertyBlocks` are excluded from authored persistence, but they are not yet consumed by
|
||||
renderer binding. Runtime application and the transactional **Promote to Material Instance**
|
||||
workflow are tracked by Gitea #53. Use an ordinary direct-base Material Instance for reusable
|
||||
variations until that issue closes.
|
||||
Resolution is strongest-first: property block, scene/prefab slot, model default, imported source,
|
||||
project default, then engine DefaultGrid. A broken explicit reference reports a diagnostic and uses
|
||||
DefaultGrid; it does not silently expose a weaker source assignment. Clearing an assignment is the
|
||||
explicit way to return to the next layer.
|
||||
|
||||
Property blocks are applied after base resolution and cached per owner/slot for both Standard and
|
||||
Surface materials, including above any sparse values already present on a selected Material
|
||||
Instance. They never mutate a shared Material asset and remain excluded from scene/prefab
|
||||
persistence. Unknown properties, schema/type/range mismatches, duplicate names, and broken texture
|
||||
references reject the complete block with a diagnostic while the resolved base stays visible.
|
||||
DefaultGrid cannot be edited, instanced, or used as a promotion base.
|
||||
|
||||
The editor registers this runtime-only component with Bevy reflection so trusted local BRP tooling
|
||||
can inject a block for debugging, gameplay integration, and promotion acceptance. Reflection does
|
||||
not make the component an authoring component: it remains absent from Add Component, excluded from
|
||||
scene/prefab serialization, and is never published by an asset save.
|
||||
|
||||
Surface evaluators specialize forward and deferred material fragments only. Bevy's standard shader
|
||||
remains authoritative for depth, normal, and motion-vector-only prepasses, so those passes never
|
||||
try to write a deferred G-buffer attachment that is not present.
|
||||
|
||||
When a selected primitive, static renderer, or skinned renderer has a runtime block, its exact material-slot card shows
|
||||
the override counts and **Promote to Material Instance**. Promotion requires an explicit project
|
||||
Material or direct-base Material Instance; imported source and DefaultGrid are intentionally
|
||||
rejected. **Promote to Material Instance** opens a review showing the selected/direct base, exact
|
||||
slot, sparse override counts, and collision-safe target path. The editor fingerprints the selected
|
||||
asset, direct base, schema, runtime block, slot assignment, and absent target while the review is
|
||||
open. Commit merges an existing instance's sparse values with the runtime block, creates one
|
||||
direct-base Material Instance in the current Content Browser folder, assigns it to that exact scene
|
||||
slot through one history transaction, and clears the runtime block only after file, registry, and
|
||||
assignment publication succeed. Cancel or any conflict leaves the block, registry, scene, and
|
||||
history unchanged.
|
||||
|
||||
## Assign materials
|
||||
|
||||
@@ -36,32 +73,74 @@ Assign through either exact workflow:
|
||||
|
||||
1. Drag a Material or Material Instance from the Material Library or Asset Browser onto the desired
|
||||
viewport surface. A hydrated static/skinned draw targets its exact stable renderer slot, a
|
||||
primitive targets its actor material, and a brush targets the exact face under the pointer.
|
||||
primitive targets its stable surface slot, and a brush targets the exact face under the pointer.
|
||||
2. Check the pointer card and target visual. Green names a valid actor/slot/face; red gives the
|
||||
blocking reason. Release commits one undoable assignment. Move away, leave the viewport, press
|
||||
Escape, or right-click to restore the pre-drag state without history or dirtying the scene.
|
||||
3. Alternatively, select a static- or skinned-mesh actor and use **Browse** or **Select** on the
|
||||
named slot in its renderer inspector. **Locate** reveals the current asset in the Asset Browser;
|
||||
**Clear** removes only the explicit assignment and restores the read-only imported source.
|
||||
3. Alternatively, select a primitive, static-mesh, or skinned-mesh actor and use its ordered
|
||||
**Materials** section. Each 82 px expanded or 52 px collapsed slot header is an assignment
|
||||
target; there is no adjacent drop
|
||||
box. A valid Material/Instance drag uses the active theme's
|
||||
selection highlight. A Texture drag
|
||||
highlights the target as invalid and explains that textures must be authored inside a Material.
|
||||
**Locate** reveals the current asset; **Clear** removes only the explicit assignment and restores
|
||||
the inherited model source, project default, or DefaultGrid.
|
||||
|
||||
From the Asset Browser, **Apply Material** assigns the selected material to every material slot on
|
||||
each selected static or skinned renderer. This is the explicit bulk path. A viewport hit never
|
||||
silently broadens to all slots.
|
||||
From the Asset Browser, **Apply Material** assigns the selected material to a primitive surface or
|
||||
every material slot on each selected static/skinned renderer. This is the explicit bulk path. A
|
||||
viewport hit never silently broadens to all slots.
|
||||
|
||||
Texture drops target a primitive's base-color texture or one brush face. Direct Texture drops on a
|
||||
renderer slot are rejected because a renderer slot stores a Material reference; create or edit a
|
||||
Material Instance and assign the texture there.
|
||||
Direct Texture drops on primitive or mesh slots are rejected because slots store Material
|
||||
references. Brush faces retain their specialized direct texture path. Create or edit a Material or
|
||||
Material Instance, assign the texture there, then assign that asset to the slot.
|
||||
|
||||
Expand any shared slot to inspect the actual effective material. At the current 620 px wide
|
||||
reference the slot/body are 596/569 px; at the hard 420 px Inspector floor they are 396/369 px and
|
||||
six parameter rows reflow to 58 px two-line rows. Project Materials and Instances open the
|
||||
same asset-keyed editor used by the Content Browser. Valid parameter changes
|
||||
update `blacksite_surface`'s live document overlay on every interaction frame; its single cache
|
||||
mutates the shared Standard or Surface handle in place, and there are no Apply/Revert buttons.
|
||||
The asset-keyed authored document becomes **UNSAVED**, survives selection changes, and performs no
|
||||
source write, Git refresh, watcher work, thumbnail invalidation, or processing when the pointer is
|
||||
released. `Ctrl+S` publishes the last edited context; `Ctrl+Shift+S` publishes every dirty editor
|
||||
document. Scalar, color, label, shader-value, emissive, and render-state saves queue no derived
|
||||
work; ARM/ORM binding changes queue one coalesced packing job. **Create Instance and Assign** transactionally publishes a
|
||||
direct-base instance and assigns only the current actor slot for local variation. Imported source
|
||||
parameters remain read-only; **Extract Editable…** opens extraction for that single source and
|
||||
assigns the resulting project Material only to the selected actor slot. The project default is
|
||||
expandable as inherited shared content. DefaultGrid is visible but read-only.
|
||||
|
||||
The final panel shows only Shader, Surface, Inputs, shared UV, and supported Advanced Inputs.
|
||||
Standard Lit stores seven inputs but reports six visible bindings: Emissive Intensity is a
|
||||
companion of Emissive color and is edited/restored through the same popup. Offset/Tiling changes affect every texture sampler on the Material in
|
||||
both Standard and Surface rendering; Material Instances may override them sparsely and Reset
|
||||
restores the base values. Texture fields open their picker on field click and expose Locate and
|
||||
Clear without a redundant folder action. Direct actor assignments do not receive an “Explicit” label. Source paths, fingerprints,
|
||||
stable IDs, orphan state, and provenance are secondary diagnostics in overflow rather than material
|
||||
parameters. The sphere preview and bounded 229.5 px reference identity live in the 82 px assignment block; preview,
|
||||
identity, and Browse open the compact current/recent Material menu without making Shader or
|
||||
action clicks assign anything. No second preview, drop box, or material-slot list is rendered.
|
||||
|
||||
Project textures are loaded from runtime-catalog sampling data rather than Bevy's default sampler.
|
||||
Repeat, Clamp, and Mirror map to Repeat, Clamp-to-edge, and Mirror-repeat for U/V/W; authored
|
||||
filtering and anisotropy apply to Standard, Surface/Solari, property-block bases, and project
|
||||
material previews. Packed AO/roughness/metallic sources must agree on filter, wrap, and anisotropy
|
||||
because their canonical ARM artifact has one sampler. A mismatch retains the previous valid
|
||||
material and reports a processing diagnostic. Imported glTF/FBX materials keep their loader-owned
|
||||
samplers.
|
||||
|
||||
See the [Material Library and targeted-drop evaluation](evaluations/material-library-targeted-drop/)
|
||||
for the live preview, commit/undo, cancel, and source-verification record.
|
||||
|
||||
Static draw slots and material slots are separate. Removing a static draw retains its explicit
|
||||
material assignment as an orphan rather than guessing a replacement. Reimport also reconciles
|
||||
slots by stable ID, never by display name. Resolve an orphan explicitly in the renderer inspector.
|
||||
slots by stable ID, never by display name. Model Details can **Locate** the preserved project
|
||||
Material/Instance or **Clear Orphan** before applying the import settings; active project/default
|
||||
model selections likewise expose **Locate** and **Clear**, with Clear restoring Source.
|
||||
|
||||
## Author shared assets
|
||||
|
||||
Material files and material-instance files are RON documents under `assets/materials/`. The
|
||||
Material files and material-instance files are typed RON documents anywhere under `assets/`. The
|
||||
Material Library and Asset Browser identify the document kind, expose the same guarded
|
||||
schema-driven editor and texture bindings, and use stable subasset IDs (`material:source` or
|
||||
`material:instance`). Material Instance thumbnails resolve the direct base plus sparse overrides.
|
||||
@@ -73,6 +152,18 @@ unchecked values continue to inherit. Material instances cannot inherit from oth
|
||||
Material render state exposes Opaque/Cutout, alpha cutoff, and Double Sided in the base Material
|
||||
inspector.
|
||||
|
||||
Materials extracted from textual glTF remain ordinary editable project assets. The extraction
|
||||
review previews and can exclude each source material, shows converted PBR/render-state/texture
|
||||
coverage, and permits collision-checked project-path edits before one atomic publication. The same
|
||||
transaction assigns each affected stable model slot to the newly registered project Material; this
|
||||
is an explicit model default, not a live source link. Their
|
||||
Details card also shows read-only provenance: source asset path, source material label/stable index,
|
||||
and a BLAKE3 source fingerprint. A later extraction detects that stable provenance, shows whether
|
||||
the source revision, shader selection, render state, or converted PBR values differ, and requires
|
||||
**Apply Reviewed Update** or **Create New Copy**. Apply replaces the file only while its reviewed
|
||||
fingerprint still matches and rolls back exact prior bytes if the dependent model mapping cannot
|
||||
publish. Provenance is not a live link and never authorizes an automatic overwrite.
|
||||
|
||||
Every standard and shader-schema texture slot uses the project texture picker. **Browse** lists
|
||||
texture assets across the project, including imported model texture subassets, and a texture can be
|
||||
dragged from the Asset Browser directly onto a slot. Non-texture drops are ignored. **Clear** removes
|
||||
@@ -80,6 +171,39 @@ the base Material value; on a Material Instance it removes the sparse override s
|
||||
from its base again. Dropping or browsing a texture onto an unchecked instance slot creates the
|
||||
override automatically.
|
||||
|
||||
## Schema-driven inputs and packed maps
|
||||
|
||||
Material schema v2 stores one canonical `MaterialInputSet`. Standard Lit and custom Surface
|
||||
shaders both describe their controls with `MaterialInputSchema`, so primitive, static-mesh,
|
||||
skinned-mesh, Content Browser, and Material Library editors render the same responsive rows. The
|
||||
exported 569 px section uses one fixed label/value/channel line beside its texture field; the 369 px
|
||||
section stacks the texture field beneath that line. A bounded transient fallback below 369 px moves
|
||||
Locate/Clear into overflow instead of allowing negative or out-of-clip geometry. Slot IDs, source
|
||||
paths, fingerprints, and usage counts are diagnostics rather than material parameters.
|
||||
|
||||
Base Color is a multiplier over its albedo texture. Metallic and Roughness are scalar multipliers
|
||||
over their selected channel; Occlusion is a scalar texture input. The **ARM / glTF ORM** preset uses
|
||||
R=ambient occlusion, G=roughness, and B=metallic. **Separate Maps** samples each map's R channel,
|
||||
while the adjacent channel selectors support custom packed layouts. Publication repacks those
|
||||
choices into one canonical linear R/G/B ARM artifact used by Standard and Surface/Solari paths.
|
||||
|
||||
Select a Texture asset to edit its semantic, color space, mipmaps, compression, maximum size,
|
||||
filtering, wrapping, anisotropy, and normal convention. Auto treats color/emissive maps as sRGB and
|
||||
normal/mask/ARM data as Linear. DirectX normals are converted to OpenGL +Y during processing.
|
||||
Texture property changes use the same **UNSAVED** document state. Saving preserves the source image
|
||||
and queues a content-addressed UASTC Basis or uncompressed KTX2 artifact below managed
|
||||
`.import-cache/runtime/` storage. The processor derives the output key from source bytes and
|
||||
normalized settings before decoding; if that exact artifact already exists, editor refresh,
|
||||
packaging, and `process-assets --check` reuse it without recompression.
|
||||
|
||||
Loose PBR image sets can be turned into editable Material assets from the Content Browser with
|
||||
**Create Materials From Folder**. The preview groups filename suffixes, reports confidence, and lets
|
||||
authors correct roles or edit a target name to merge/split sets before publication. Base-color,
|
||||
normal, and packed ORM/ARM maps populate the Standard material fields; occlusion and separately
|
||||
authored roughness, metallic, or height maps are also retained as named Surface texture bindings.
|
||||
The batch is transactional and never overwrites an existing Material file. See the
|
||||
[content-workspace guide](content-workspace.md) for the full workflow.
|
||||
|
||||
The supported render states are:
|
||||
|
||||
- **Opaque** — no alpha candidate test.
|
||||
@@ -91,7 +215,10 @@ Editing a shared asset never writes copies into renderer components. The runtime
|
||||
Material, direct base, shader schema, and evaluator dependencies and updates the shared hydrated
|
||||
handle in place. Standard and custom Surface changes therefore propagate to every assigned static
|
||||
or skinned renderer slot without reloading geometry, joints, or the current animation pose. Invalid
|
||||
Surface edits retain the last-good evaluator generation and emit diagnostics.
|
||||
Surface edits retain the last-good evaluator generation and emit diagnostics. The neutral
|
||||
`StandardMaterial` attached during hydration is only a singleton emergency visibility handle. It
|
||||
is never reused for an assigned asset: the resolver caches one live handle per `MaterialRef`, so
|
||||
users of the same Material share updates while unrelated Materials cannot overwrite one another.
|
||||
|
||||
Renderer and terrain material bindings target generated draw entities. Scene switches may remove
|
||||
those entities between binding discovery and deferred command application, so binding replacement
|
||||
@@ -154,8 +281,11 @@ cargo upgrade-project --project .
|
||||
cargo upgrade-project --project . --apply
|
||||
```
|
||||
|
||||
Apply mode stages the complete rewrite, creates a timestamped backup under
|
||||
`.blacksite/backups/material-component-v4-*`, and rolls back on failure. Commit or otherwise back up
|
||||
Repository scenes use schema v6 for actor-only slot ownership. This pre-production project updates
|
||||
fixtures directly rather than carrying a generalized v5 compatibility migrator. The explicit
|
||||
upgrade path converts legacy primitive/mesh descriptors and per-slot overrides into generalized saved slots, and deduplicates canonical descriptors into project
|
||||
Materials under `assets/materials/migrated/`. It stages the complete rewrite, creates a timestamped
|
||||
backup under `.blacksite/backups/material-slot-v5-*`, and rolls back on failure. Commit or otherwise back up
|
||||
the project before applying, inspect the diff afterward, then run:
|
||||
|
||||
```bash
|
||||
|
||||
@@ -35,10 +35,11 @@ builds apply the same data without loading the editor plugin.
|
||||
|
||||
Select a generated prefab member to edit its override layer. The current inspector exposes:
|
||||
|
||||
- **Property overrides** for Transform position, rotation, and scale, plus Material base color,
|
||||
metallic, and roughness.
|
||||
- **Component overrides** for adding, replacing, or removing `MaterialDesc`, plus visibility on
|
||||
direct or nested generated actors.
|
||||
- **Property overrides** for reflected authoring-component fields, including Transform fields and
|
||||
brush-only legacy `MaterialDesc` parameters.
|
||||
- **Component overrides** for adding, replacing, or removing registered authoring components, plus
|
||||
visibility on direct or nested generated actors. Primitive and mesh material assignments live in
|
||||
their owning `MaterialSlot` data; `MaterialDesc` is not a general mesh/primitive material path.
|
||||
- **Structural overrides** for removing a source actor or reparenting generated actors within the
|
||||
same instance layer. Hierarchy **Unparent override** writes the same stable structural operation.
|
||||
|
||||
|
||||
@@ -51,9 +51,11 @@ the browser exits only after a new editor process has been accepted by the user'
|
||||
This keeps renderer, asset server, import registry, and project settings rooted consistently.
|
||||
|
||||
On the supported Linux workstation, the **Blacksite Editor** desktop entry provides an **Open
|
||||
Project Browser** action. Its wrapper builds both editor binaries into the shared target directory,
|
||||
shows the normal startup splash, avoids duplicate browser processes, and preserves the Wayland,
|
||||
session-bus, graphics, and XDG environment required by the detached process.
|
||||
Project Browser** action. Its wrapper launches the current managed development binary directly,
|
||||
shows the normal startup splash, avoids duplicate processes, and preserves the Wayland, session-bus,
|
||||
graphics, and XDG environment required by the detached process. A desktop click never invokes Cargo.
|
||||
An explicit `~/.local/bin/blacksite-editor --build-only` rebuild uses the repository's managed Cargo
|
||||
lane; a missing binary produces an actionable splash error instead of starting an implicit build.
|
||||
|
||||
The browser's **New Sandbox** workflow requires a missing or empty folder and a non-empty name.
|
||||
Creation failures remain in the browser as status text; a successful scaffold is validated and
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Editor Framework Release Notes (1.0 baseline)
|
||||
|
||||
> **Historical release snapshot — not current implementation guidance.** Use the [documentation index](../README.md) for current behavior and architecture.
|
||||
|
||||
## Shipped
|
||||
|
||||
- Stable asset registry (`assets/.index/registry.ron`) with import settings and content-addressed
|
||||
|
||||
@@ -74,9 +74,11 @@ Material authoring includes emissive color, emissive intensity (nits), and an op
|
||||
|------|---------|
|
||||
| `assets/rendering_profiles/*.ron` | Named override bundles (`RenderingProfileAsset`); Apply / Revert in volume inspector |
|
||||
| `assets/post_fx/*.ron` + `.wgsl` | Fullscreen effects (`PostProcessEffectAsset`); picker in volume inspector |
|
||||
| `assets/materials/*.ron` | Material presets, including emissive fields for Solari-compatible surfaces |
|
||||
| Material/Instance documents anywhere under `assets/` | Schema-classified shared materials, including emissive inputs for Solari-compatible surfaces |
|
||||
|
||||
Shipped examples: `post_fx/vignette.ron`, `post_fx/chromatic_aberration.ron`, `rendering_profiles/cave_dark.ron`, `rendering_profiles/outdoor_haze.ron`, `materials/emissive_panel.ron`.
|
||||
Shipped examples use the conventional `post_fx/`, `rendering_profiles/`, and `materials/` folders,
|
||||
but project Material/Instance location is organizational rather than type authority. See the
|
||||
[Content Workspace guide](content-workspace.md).
|
||||
|
||||
## Game team checklist
|
||||
|
||||
|
||||
@@ -4,7 +4,10 @@ Phased work for the in-process editor (`crates/editor`). Status reflects the cur
|
||||
|
||||
## Production editor program (P5 cleanup remaining)
|
||||
|
||||
**Goal:** Zero-debt authoring loop — hydration modules, mandatory `ActorKind`, actor inspector only, schema v2 migrations. See [ADR 0009–0012](../adr/0009-authoring-vs-hydrated.md) and `.cursor/plans/editor_rendering_and_ux_*.plan.md`.
|
||||
**Goal:** Zero-debt authoring loop — hydration modules, derived `ActorKind`, a registered actor
|
||||
inspector, and explicit schema migrations. See [ADR 0009](../adr/0009-authoring-vs-hydrated.md),
|
||||
[ADR 0034](../adr/0034-registry-driven-authoring-components.md), and the
|
||||
[documentation authority map](../authority.toml).
|
||||
|
||||
| Phase | Status | Notes |
|
||||
|-------|--------|-------|
|
||||
@@ -13,7 +16,7 @@ Phased work for the in-process editor (`crates/editor`). Status reflects the cur
|
||||
| P2 Actor inspector | **Done** | `ui/actor_inspector/`; removed `DefaultInspectorConfigPlugin` + ECS dump on Inspector tab |
|
||||
| P3 Hierarchy tree + sibling order | **Done** | `HierarchySiblingIndex`, tree outliner, full-row DnD attach/reorder/root, world-transform preservation, cycle guards, visibility/lock |
|
||||
| P4 Viewport modes | **Done** | Lit / Unlit / Collider toolbar, light gizmo overlays, Tab pick cycle |
|
||||
| P5 Assets + prefabs | **Partial** | Prefab v2 is production-accepted with stable nested identity, scoped/runtime overrides, committed base/nested/variant fixtures, source Apply/conflict recovery, and local conversion; legacy `fbx_preview` cleanup remains |
|
||||
| P5 Assets + prefabs | **Done** | Prefab v2 is production-accepted with stable nested identity, scoped/runtime overrides, committed base/nested/variant fixtures, source Apply/conflict recovery, and local conversion; the legacy `fbx_preview` crate/path is absent from the current workspace |
|
||||
| P6 Extensibility + CI | **Done** | `ActorInspectorSection`, palette commands, BRP policy, hydration/scene CI |
|
||||
| P7 Docs + debt audit | **Done** | ADRs 0009–0012, [debt-audit.md](debt-audit.md), CI matrix |
|
||||
|
||||
@@ -109,7 +112,7 @@ Phased work for the in-process editor (`crates/editor`). Status reflects the cur
|
||||
| Pause in PIE | Done | `PlayPaused` freezes sim while staying in Play (`F6`) |
|
||||
| Dock layout persistence | Done | `ui/layout.rs` + `UserPreferences.dock_layout` |
|
||||
| Hierarchy tree + type icons | Done | Authored + generated/runtime rows, persistent expansion, full-row attach targets, subtree-safe multi-drag, transform-preserving undo |
|
||||
| Actor inspector (authoring-only) | Done | Transform + `LightDesc`/`MaterialDesc`/…; no bevy_inspector dump |
|
||||
| Actor inspector (authoring-only) | Done | Transform plus registered authoring components; primitives/static/skinned renderers use stable `MaterialSlot` ownership; no bevy_inspector dump |
|
||||
| Inspector component headers | Done | Header + Transform + component cards + Add Component footer |
|
||||
| Asset browser project/file views | Done | Folder tree, breadcrumb, search/filter/sort, grid/list, details pane, texture + model thumbnails |
|
||||
|
||||
@@ -121,7 +124,7 @@ Phased work for the in-process editor (`crates/editor`). Status reflects the cur
|
||||
|------|--------|-------|
|
||||
| `asset_db.rs` registry | Done | Stable UUIDs by path/content, deterministic model/texture/audio BLAKE3 fingerprints, normalized publication order, and import settings in details |
|
||||
| Model import formats | Done | glTF/GLB + binary FBX; sandboxed `textures/`/`.fbm/` discovery and transactional referenced-bundle copy |
|
||||
| Thumbnails | Done | Textures via asset load; glTF albedo fast-path; direct neutral FBX geometry; preflighted source-material dependency state |
|
||||
| Thumbnails | Done | Typed texture/model/mesh/material cache keys; textures via asset load; all model and mesh cards via offscreen geometry studio; preflighted dependency failures |
|
||||
| Import settings per asset | Done | Scale/collider/LOD in registry + details pane |
|
||||
| Prefab workflow | Done | Shared stable nested property/component/structural overrides, recursive validation, committed variant fixtures, transactional source Apply, conflict recovery, and undoable outer unpack/recursive local conversion passed headless, packaged-runtime, and live editor acceptance in Gitea #43 |
|
||||
| Curated editor regression samples | Done | Versioned five-area manifest, dedicated brush/material labs, strengthened terrain/physics/rendering fixtures, **File > Open Sample**, typed scene coverage, and `validate-samples` release gate in Gitea #32 |
|
||||
|
||||
@@ -17,12 +17,20 @@ or credentials.
|
||||
Discard confirmation, the last authored scene and non-destructive UI state are restored.
|
||||
- **Abnormal shutdown:** the editor opens its normal safe scene and displays **Recover Editor
|
||||
Session**. **Resume Last Scene** opens only the previous authored scene. **Continue Safe** keeps
|
||||
the startup scene. Modal tools and dirty preview state are never restored.
|
||||
the startup scene. The prompt blocks interaction with the safe scene until either choice is made.
|
||||
Modal tools and dirty preview state are never restored.
|
||||
- Native window close, **File > Quit**, project switching, and programmatic editor exit use one
|
||||
non-blocking Save All / Discard / Cancel workflow. Cancel and failed saves keep the session open.
|
||||
Direct `AppExit`, process kill, and crashes are not recorded as clean shutdowns.
|
||||
- Dirty scene data remains governed by the independent scene recovery workflow in
|
||||
[ADR 0023](../adr/0023-transactional-scene-persistence-and-recovery.md).
|
||||
- Dirty Materials, Material Instances, import settings, and project content defaults receive
|
||||
editor-local recovery snapshots after two seconds of inactivity. Five generations are retained
|
||||
outside project `assets/`. Startup restoration never overwrites source: a changed fingerprint
|
||||
restores the document as a conflict. Returning the document exactly to its source value clears
|
||||
older recovery generations; startup defensively ignores any recovery value that already matches
|
||||
source. See
|
||||
[ADR 0047](../adr/0047-editor-authored-asset-documents.md).
|
||||
|
||||
An unknown newer session schema is ignored safely. Legacy unversioned session documents migrate to
|
||||
v1 after finite camera bookmark validation.
|
||||
|
||||
@@ -15,12 +15,18 @@ An **in-process Bevy editor and game foundation** for a server-authoritative mul
|
||||
7. **Composable actor model** — Every saved level object carries a derived `ActorKind` display hint,
|
||||
while registered authoring components own behavior, requirements, conflicts, persistence, and
|
||||
hydration ([ADR 0034](adr/0034-registry-driven-authoring-components.md)).
|
||||
8. **Sustainable extension seams** — Pay architecture debt at the point of change: thin panel
|
||||
shells dispatch into bounded domain modules and shared services, with an automated no-growth
|
||||
ratchet for legacy modules ([ADR 0048](adr/0048-modular-editor-composition-and-debt-ratchet.md)).
|
||||
9. **Authored visual language** — Build editor panels from semantic, responsive design-system
|
||||
primitives whose native output is accepted against the Penpot source of truth; unsupported mock
|
||||
controls do not ship ([ADR 0049](adr/0049-penpot-led-editor-visual-system.md)).
|
||||
|
||||
## Audience
|
||||
|
||||
- **Level authors** — Iterate on scenes, tuning, and feel via PIE and project settings.
|
||||
- **Engine extenders** — Reuse or embed `editor` patterns (viewport, history, PIE) in other Bevy projects.
|
||||
- **Automation / CI** — BRP and headless validation (planned).
|
||||
- **Automation / CI** — BRP, headless validation, and deterministic asset processing.
|
||||
- **Multiplayer development** — Same editor shell exercises deterministic sim and protocol types.
|
||||
|
||||
## Non-goals
|
||||
|
||||
@@ -0,0 +1,32 @@
|
||||
# Build Storage Policy
|
||||
|
||||
Blacksite uses one persistent ordinary-development lane and creates exceptional candidate,
|
||||
hot-reload, full-debug, cross-target, or package lanes only when their distinct signature is needed.
|
||||
Lane identity includes the canonical workspace, toolchain, target, profile, features, linker and
|
||||
compiler flags.
|
||||
|
||||
On the current checkout, intermediates live in a canonical-workspace partition beneath
|
||||
`<workspace-parent>/.blacksite-build-cache`; this keeps the cache on the workspace volume because
|
||||
Cargo home does not satisfy the configured free-space floor. Set `BLACKSITE_BUILD_CACHE_ROOT` to an
|
||||
approved cache volume when the checkout moves. Final ordinary artifacts retain predictable paths
|
||||
under repository `target/`, while exceptional final artifacts live under `target/lanes/<lane>`.
|
||||
|
||||
Use `scripts/codex/build_storage.py` for measurement, dry-run pruning, and policy enforcement. Under
|
||||
budget or free-space pressure, pre/post enforcement may automatically remove only expired disposable
|
||||
lanes after printing and flushing their complete byte-counted safety plan. A managed lane must carry
|
||||
a sentinel identifying its workspace and signature before it is eligible for
|
||||
deletion. Never run an unscoped `cargo clean` as a troubleshooting reflex, and never delete individual
|
||||
files from Cargo's `deps`, `.fingerprint`, `build`, or `incremental` layouts by age. Pruning removes
|
||||
only a complete verified disposable lane.
|
||||
|
||||
Before a heavy gate, enforce the configured total budget and free-space floor; remaining hard-limit
|
||||
or free-space violations block the gate. Afterward, record lane size and last use. Every automatic or
|
||||
explicit prune/reset prints and flushes its complete byte-counted, checked plan before deletion starts.
|
||||
Before removing a candidate lane, copy the nominated binaries or
|
||||
packages and evidence outside the lane, then run:
|
||||
|
||||
`python scripts/codex/build_storage.py mark-candidate-preserved --evidence <manifest> --artifact <binary-or-package>`
|
||||
|
||||
The generation-bound marker becomes stale if that candidate lane is used again. The persistent
|
||||
development lane is reset only at a safe slice boundary when signature drift or the hard budget makes
|
||||
that necessary.
|
||||
@@ -0,0 +1,30 @@
|
||||
# Codex Workflow
|
||||
|
||||
Blacksite uses a repository-local workflow to keep implementation fast without weakening acceptance.
|
||||
The compact operating rules live in `AGENTS.md`; procedural details live in repository Skills and the
|
||||
policies indexed here.
|
||||
|
||||
## Task lifecycle
|
||||
|
||||
1. Confirm the canonical repository path, branch, HEAD, dirty state, and active processes.
|
||||
2. Resume `.codex/session/STATE.md` when valid instead of rediscovering the repository.
|
||||
3. Read `docs/authority.toml`, the smallest relevant current docs, and exact linked tracker items.
|
||||
4. Define one bounded slice with acceptance criteria, non-goals, and a verification tier.
|
||||
5. Record material user steering as a scope delta, including which evidence remains valid.
|
||||
6. Run selective verification, then update canonical docs at the slice boundary.
|
||||
7. Treat native acceptance and release-candidate gates as separate states from engineering checks.
|
||||
|
||||
Ignored `.codex/session/`, `.codex/logs/`, `.codex/cache/`, and `.codex/evidence/` data is working
|
||||
state, not documentation. It exists to make reconnects and compaction cheap and must not become a
|
||||
second source of product truth.
|
||||
|
||||
## Policies
|
||||
|
||||
- [Documentation authority](documentation-policy.md)
|
||||
- [Selective verification](verification-policy.md)
|
||||
- [Build storage](build-storage-policy.md)
|
||||
- [Gitea tracking](gitea-tracking-policy.md)
|
||||
|
||||
The workflow distinguishes Implementing, Engineering-complete, Acceptance-in-progress,
|
||||
Candidate-ready, and Accepted/closed. “Complete” is reserved for the acceptance state actually
|
||||
proven; a dirty worktree or source-only check is not closure evidence.
|
||||
@@ -0,0 +1,52 @@
|
||||
# Documentation Authority Policy
|
||||
|
||||
`docs/authority.toml` classifies every root README, repository documentation page, and Cursor plan
|
||||
before it may be used as guidance. Run `python scripts/codex/docs_audit.py` after changing behavior,
|
||||
schemas, commands, component names, workflows, plans, or evidence records.
|
||||
|
||||
## Authority order
|
||||
|
||||
For desired scope and acceptance, use the latest user direction, exact current Gitea scope, and then
|
||||
an active plan. For implemented behavior, use source and tests, then current native evidence and
|
||||
canonical current documentation. Accepted ADRs own architecture decisions. Do not merge conflicting
|
||||
sources silently; report and reconcile the conflict at the smallest owning surface.
|
||||
|
||||
## Classifications
|
||||
|
||||
Each authority rule has a lifecycle classification and a role. Lifecycle controls whether a page
|
||||
may guide current work; roles distinguish overview, canonical behavior, architecture, active plan,
|
||||
evidence, historical record, and superseded record. Accepted ADRs use the architecture role and are
|
||||
authoritative only for their surviving decision scope.
|
||||
|
||||
| Class | Meaning | May define current behavior? |
|
||||
|-------|---------|------------------------------|
|
||||
| `current` | Canonical workflow, architecture, intent, or user guidance | Yes, within its stated role |
|
||||
| `active-plan` | Unaccepted desired scope and acceptance work | No; source and current docs describe what exists |
|
||||
| `evidence` | Dated automated or native observations | No |
|
||||
| `historical` | Preserved context from completed work | No |
|
||||
| `superseded` | Replaced contract retained for provenance | No |
|
||||
|
||||
Historical and superseded documents carry an obvious banner linking current guidance. Evidence
|
||||
records carry an evidence-only banner. Active plans identify themselves and must become historical
|
||||
when their acceptance target is complete.
|
||||
|
||||
## One home per fact
|
||||
|
||||
- Root `README.md`: user commands, controls, troubleshooting, and shipped checklist.
|
||||
- `docs/mission.md`: product intent and non-goals.
|
||||
- `docs/adr/`: accepted decisions and durable constraints.
|
||||
- `docs/editor/`: current editor workflows and subsystem contracts.
|
||||
- `.cursor/plans/`: active or historical implementation roadmaps, never implementation truth.
|
||||
- `docs/editor/evaluations/`: dated evidence, never product requirements.
|
||||
- `docs/archive/`: preserved records that no longer belong in a live topic tree.
|
||||
|
||||
Update canonical documentation when behavior stabilizes at a slice boundary. Tiny intermediate edits
|
||||
do not require repeated narrative churn, but the slice cannot become engineering-complete while its
|
||||
canonical docs contradict the implementation.
|
||||
|
||||
## Audit contract
|
||||
|
||||
The audit discovers `README.md`, every `docs/**/*.md`, and every `.cursor/plans/**/*.md`. The
|
||||
highest-priority matching authority rule wins; equal-priority disagreement fails. It also verifies
|
||||
lifecycle banners and configured replacement links. New documents fail until a deterministic rule
|
||||
classifies them.
|
||||
@@ -0,0 +1,17 @@
|
||||
# Gitea Tracking Policy
|
||||
|
||||
Read exact issue, epic, and milestone records rather than broad tracker dumps. Current tracker scope
|
||||
is desired behavior; source and accepted evidence determine implementation state.
|
||||
|
||||
Use these states precisely: Implementing, Engineering-complete, Acceptance-in-progress,
|
||||
Candidate-ready, and Accepted/closed. Do not check an acceptance criterion without corresponding
|
||||
code, automated, native, or candidate evidence. A dirty working tree cannot close an issue, and
|
||||
closure requires the nominated commit plus configured release evidence.
|
||||
|
||||
Post at most one useful status update per completed slice or material scope delta. Keep epic
|
||||
checklists, child issues, and milestone scope aligned, but do not create, close, reopen, delete, or
|
||||
rewrite tracker scope without direct authority. Workflow installation and audits produce dry-run
|
||||
recommendations only.
|
||||
|
||||
Tracker comments summarize outcomes and link durable repository evidence; they do not receive raw
|
||||
build logs, entire issue listings, or speculative completion claims.
|
||||
@@ -0,0 +1,25 @@
|
||||
# Selective Verification Policy
|
||||
|
||||
Verification is proportional to the changed dependency surface and is reused while its inputs,
|
||||
toolchain, features, environment, and command remain unchanged.
|
||||
|
||||
| Tier | Use | Typical scope |
|
||||
|------|-----|---------------|
|
||||
| Fast loop | Ordinary implementation edits | Formatting as needed, affected package check, focused tests |
|
||||
| Slice gate | A bounded behavior slice is stable | Affected package tests and lint plus relevant domain validators |
|
||||
| Candidate gate | An exact release candidate is nominated | Full workspace/all-feature gates, deterministic content checks, packaging, and named native scenarios |
|
||||
|
||||
Codex Cargo commands run through `scripts/codex/verify.py` or `scripts/codex/cargo_lane.py`; complete
|
||||
output belongs in `.codex/logs/`. Do not run a candidate gate during ordinary iteration, duplicate a
|
||||
workspace check immediately before a compiling workspace test without a distinct target reason, or
|
||||
rerun a valid gate after unrelated documentation changes.
|
||||
|
||||
User steering invalidates only gates whose inputs or acceptance claim changed. Record that boundary
|
||||
in session state. Automated tests are not native editor acceptance, and screenshots alone do not
|
||||
prove an interaction.
|
||||
|
||||
When native acceptance is explicitly delegated, `scripts/codex/native_qa.sh plan <scenario>` prints
|
||||
the named steps and assertions before anything launches. The runner snapshots a declared fixture,
|
||||
records each manual assertion and target-window capture, closes only its recorded PID, and exposes a
|
||||
hash-checked `restore --dry-run` / `restore --apply` pair. Planning a scenario never launches the
|
||||
editor, and Codex does not take over user-owned visual QA merely because a scenario exists.
|
||||