OverviewFilesCommitsIssuesDocsReleasesPeers

hyper-tps commits / 42d7982

docs: #120 L4 §15 — user answers (menu-only save, own placements follow a re-save, drop up = snapped normal)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
42d798295534ce12586599b60a2c66b0e7842893
by plankatron <fleeky@gmail.com> · 2026-10-19T20:34:55.000Z

Changed files (1) +18 -14

docs/node-tree-and-stacks.md +18 -14
……@@ -1220,10 +1220,13 @@ instance groups works unchanged (the groups have stable names). Modifiers on a p
12201220 - **personal:** copy both into `user://assets/<oid>.hasset` / `<oid>.png` and add
12211221 `{name, oid, thumb, saved}` to `user://assets/index.json`.
12221222 - Default: both. A checkbox in the save prompt.
1223- **Saving under a name that exists** makes a NEW oid (the content changed). Existing
1224 placements keep their pinned oid. The browser marks a tile "N placements on an older
1225 version" with **Update placements** (one gesture of `asset.set` on each). Never silent:
1226 a peer's re-save must not move your level under you.
1223- **Saving under a name that exists** makes a NEW oid (the content changed). Then
1224 (user 2026-10-19):
1225 - placements YOU made (their `asset.place` author is you) follow it: the save writes
1226 `asset.set` on each, in the save's gesture, so one Ctrl+Z undoes the save's effect;
1227 - placements OTHERS made keep their pinned oid. The browser marks the tile "N
1228 placements on an older version" with **Update placements** (one gesture of
1229 `asset.set` on each). A peer's re-save never moves your work under you.
12271230- **Personal asset into a room:** dragging / placing one publishes it to the room first
12281231 (blob + thumbnail + catalogue entry), then places it.
12291232- Delete from a library: the catalogue entry only (room) / the index line + files
……@@ -1264,8 +1267,8 @@ instance groups works unchanged (the groups have stable names). Modifiers on a p
12641267| Make Real | the placement → ordinary records | Object menu (existing key) |
12651268| — | Update placements | browser tile menu |
12661269
1267Every command gets a menu entry; none needs a new key beyond the Add menu (a key is
1268offered in the questions below).
1270Every command gets a menu entry; none needs a new key beyond the Add menu (user:
1271Save as asset is menu-only for now).
12691272
12701273### 15.8 Steps (each gated, one commit each)
12711274
……@@ -1279,8 +1282,8 @@ offered in the questions below).
12791282 of each; a missing blob → the wire box, then the real pieces when it arrives.
128012833. **Libraries + Save as asset**: room (ContentOverlay + AssetSync kind `asset`, the
12811284 extra field) and personal (user://assets). `gate_asset_library`: save → listed in
1282 both; re-save → new oid, old placements unchanged, Update placements moves them; a
1283 personal asset placed in a room is published first.
1285 both; re-save → new oid, YOUR placements follow (one undo restores them), OTHERS'
1286 stay until Update placements; a personal asset placed in a room is published first.
128412874. **Editor**: outliner rows, selection mapping, G / R / X / Shift+D / Alt+D, Make Real.
12851288 `gate_asset_edit`: each, plus Make Real = the same digest, then ordinary editable
12861289 records (a shape param edit works on one).
……@@ -1299,10 +1302,11 @@ offered in the questions below).
12991302- Editing an asset in place (Blender's "edit the library file"): v1 is Make Real a copy,
13001303 edit it, Save as asset under the same name, Update placements.
13011304
1302### 15.10 Questions for the user
1305### 15.10 Answered (user 2026-10-19)
13031306
13041. A key for **Save collection as asset**? (Blender's Mark as Asset has none.)
13052. Should **Update placements** after a re-save be offered per tile (as designed), or
1306 automatic for placements YOU made and offered for others'?
13073. Drop orientation: **up = the hit normal snapped to an axis** (as designed), or always
1308 world up?
13071. **Save collection as asset**: menu entries only for now (Object menu, outliner
1308 context menu), no key.
13092. **Re-save**: your own placements follow automatically; others' get Update
1310 placements (§15.4).
13113. **Drop orientation**: up = the hit surface's normal snapped to the nearest world
1312 axis (floor stands, wall sticks out, ceiling hangs), as §15.5; R adjusts after.