Luce packages
LuceLuce BaseLuciaOS

dymokomi/luced-3d

Source of release 0.11.7

0.11.7 / docs / PROJECTS.md

# Projects and UI persistence

`project_graph` owns the version-1 editor schema inside a Prism 4.0 text document.
`project_values` validates types, finite values, IDs and inspector-compatible
text. `project_file` handles atomic Prism saves and project-relative geometry
references. `project_session` owns native file dialogs, dirty state, commands and
the Save / Don't Save / Cancel lifecycle. No custom file parser is used.

`/scene` is a `luced3d` prim with a `network` child containing stable `n<ID>`
node prims. Nodes author input IDs, parent container ID, output/enabled/visibility,
name, position and typed parameter arrays. Ordered Edit children retain operation
kind, element IDs, a 64-bit topology hash guard, displacement and amount.
Every property the writer writes is required on load: there is one format and
no conversion of earlier ones. `/scene/view`
stores camera and graph pan/zoom. Cached geometry, worker progress and undo history
are deliberately not serialized. This is an editor schema built on Prism, not
an OpenUSD interchange schema or an embedded copy of external assets.

Loads validate the full file, port counts (none on an object level), IDs, DAG
cycles, parent hierarchy, the kinds each network may hold, one display flag per
data network, selection/scope and camera before replacing live state. Files are bounded to
64 MiB. Missing source geometry is an ordinary File-node error; it does not make
an otherwise valid project unreadable. Worker generations and source revisions
prevent old computations from replacing a newly opened document.

Saving commits an active authoring gesture. Dirty state compares authored data
against the saved snapshot, so undoing back to that state clears the marker;
camera motion, selection and cooked results don't mark the document dirty.
Prism writes through a synchronized temporary file and atomic replacement.

`ui_state` writes a separate small Prism preference document at
`~/.luced-3d/ui.prisma`, at most twice per second and only on change. `dock_layout`
validates then restores DStack's native layout text using stable panel IDs, with
splits, tab order/selection and floating rectangles. All panels may float.
Version 7 adds the tool shelf: `shelf_open`, and `shelf_tabs`, each
context's last tab as `context=tab` pairs joined by `;`. Invalid
settings fall back to the default workspace with a warning and are preserved for
inspection rather than silently overwritten. Absolute OS window position and
monitor assignment are not persisted yet.

Regression coverage includes Group and Edit round trips, quoted/Unicode text,
relative external files and Save As relocation, dirty undo/redo, cancellation,
failed-load atomicity, invalid cycles/text, floating viewport/all-floating layouts,
split/tab restoration, preferences and corrupt-file preservation. Native Metal
captures now accept `--width`, `--height` and `--viewport-only`; actual pixel sizes
are reported, since the window system may constrain the requested dimensions.

Context containers, Input and Import nodes use the same v1 schema. Startup and
File → New open at Scene, with a Box inside Geo.