Bring Home and Architecture up to date (#85)

Architecture.md

@@ -123,8 +123,8 @@ src/core/model/        Project (object holders), Asset + AssetTypes, SceneObject
 src/core/properties/   PropertySchema, kinds (one row per value kind), listItems (an item's kind, read off its value), resolve (the only override merge), deviation (what is gold), collider/camera/bounds geometry, clip (the region clip areas cut each object to, a convex polygon, #260) (with the side a one-way collider blocks from, and the rectangle around a shape a broad phase looks at first, #184), convex (capsules and polygons: rounded convex pieces against each other), ray (where a ray meets a shape, in double precision), rigidbody (what the engine reads off a rigidbody, a collider's material and the scene), joint (what it reads off a joint: its settings, where its far end is, its length and a hinge's limits, #154), aspect, enabled, editorRun, assetRef/textureRef (how a reference reads), declaredRows (the row a Property node declares in a shader or particle graph, and the params that node has in both)
 src/core/util/         list (take out, put back and move an item — what a command's undo is made of), vec (dot, the closest point on a segment — shared by the collider maths, the outline hit area and the polygon grips; a cubic Bezier at `t` and cut in two at `t` — shared by vector art, its Boolean operations and the curve grips), color (`mixColor`, channel by channel — keys of an animation, stops of a gradient, the particles' Mix colour), recorder (#253: assignments taken back last first — the undo of an edit whose reach is not known in advance)
 src/core/commands/     undoable commands (pixelArtCommands: one command runs any pixel art edit and keeps the state before it, #130), CommandStack, SetBagValueCommand base, RenameCommand base (undone by renaming back: variable, struct field, port), MoveCommand base (undone by moving back: tile picture, tilemap layer, vector shape), vectorArtCommands (#129: the shapes of a drawing, one gesture one command), one import command shape for texture/font/sound, require.ts (validated lookups, and what an instance may not change), naming.ts
-src/core/graph/        graph model, NodeRegistry/NodeContext/values (a travelling list may hold live objects, `storedList`
-                       narrows one down to what a PropertyBag may hold, #157), interpreter, dropTarget, nested (behaviors as nodes),
+src/core/graph/        graph model, NodeRegistry/NodeContext/values (a travelling list may hold live objects, #157;
+                       liveObjects' `withoutObjects` empties them on every way out of the run, #238), interpreter, dropTarget, nested (behaviors as nodes),
                        emitGraph (the walk both graph compilers share: each node once, in dependency order; cycles and property names reported),
                        sharedState (what a run shares: a bag per Variables asset, the state of a global machine; what a scene change carries forward and what it starts afresh, #164),
                        eventOrder (#264: the Order setting of event nodes and how the pulses of one event kind are sorted),
@@ -199,6 +199,11 @@ src/viewport/          WorldViewport (the drawing of a world or a holder, the ba
                        CPU and laid side by side onto one canvas, so a frame is cut out like a texture frame),
                        SoundLibrary, ShaderLibrary, ParticleLibrary,
                        particles (one ParticleContainer per source), tilemap (one container per layer),
+                       shaderPicture (the picture a shader is laid over when it shades a camera's frame, #299, or
+                       a particle field, #170: drawn anew each time into a render texture kept while its size
+                       holds, the replaced one freed once the shader holds the new; cameraShade and the field
+                       shader both draw through it), shaderPasses (the pictures of a shader's Pass nodes, #301),
+                       quadPadding (the quad a shader's Padding grows, and the plain unit quad without one),
                        drawOrder (objects and tilemap layers by z, #174, rows of a layer sorted by Y, #228), activeCamera — no editor concepts,
                        so tests reach it freely
 src/editor/            App → Editor (layout + ticker), PlaySession (the run),
@@ -263,7 +268,8 @@ src/editor/viewport/   FreeViewport (a camera of its own: fit, pan, wheel zoom)
                        tilemapPainting (brush, eraser, rectangle, fill and pick on the selected map),
                        polygonCorners (a polygon collider's corner handles, #151), tilemapSolids (where a placed
                        map blocks, outlined like a collider, #132/#173)
-src/editor/inspector/  Inspector panel, host (what a section builds into), field factory, previewHandlers (scrub → preview → command), valueSpecs
+src/editor/inspector/  Inspector panel, host (what a section builds into, and `emptyHost`, the empty one the
+                       Inspector, the Variables tab and the Tilemap panel each start from), field factory, previewHandlers (scrub → preview → command), valueSpecs
                        (where a value lives — shared with the inline lists),
                        one section per selection kind (asset/object/node/frame/shape), variableRows (one row shape for
                        every variable), shapeSection (the shapes of a vector drawing: the list, the four order

Home.md

@@ -10,22 +10,24 @@ Live: <https://nockal.com/game-maker/> · Widget playground: <https://nockal.com
 | Page | What it covers |
 |---|---|
 | [Concepts](Concepts) | Assets, scene objects, overrides, containers, play mode, the camera, the console, editing while playing, running without Play |
-| [Accounts](Accounts) | Signing in and out, the three accounts, who a project belongs to, how a session outlives a deployment |
+| [Accounts](Accounts) | Signing in and out, roles and the accounts, who a project belongs to, how a session outlives a deployment |
 | [Scenes](Scenes) | The active scene and the start scene, the switch next to Play, `Load scene` and what a swap keeps |
 | [Scene editing](Scene-editing) | Placing by drag, editor symbols, z-order, hierarchy and parenting, the editor offset |
 | [Behaviors](Behaviors) | Node graphs: variables and properties, Variables assets, the node set, structs and lists, loops, behaviors as nodes, editing the graph, the live view |
+| [Structs](Structs) | Struct assets: a named shape that struct variables, fields and `Pack`/`Expand` follow |
 | [Colliders](Colliders) | Collider assets, collision events, blocking movement |
-| [Physics](Physics) | Rigidbodies, the collider material, gravity and units, the fixed step, the contact on `On collision enter` |
+| [Physics](Physics) | Rigidbodies, the collider material, gravity and units, the fixed step, the contact on `On collision enter`, joints |
 | [Textures](Textures) | Getting images in, where they go, tinting, the filter, frames, nine-slice, upload limits |
 | [Vector art](Vector-Art) | The vector art asset, canvas and shapes, the Pen and Select tools, the shape list, how a drawing is worn |
 | [Pixel art](Pixel-Art) | The pixel art asset and its palette, the tools, layers and frames, onion skin and the preview, resizing, how frames are worn and where the pixels are stored |
 | [Fonts](Fonts) | Uploading a typeface, what a text wears, what the editor falls back to |
 | [Sounds](Sounds) | Uploading a sound, what the asset says, `Play sound` and `Stop sound`, what a pause and a stop do to a voice |
 | [Animations](Animations) | Animation assets, the Animation tab, how they run |
+| [Curves](Curves) | Easings drawn by hand, the Curve tab, using one on a key or a `Lerp` |
 | [Tiles](Tiles) | The tile asset, plain tiles and the two autotile kinds, the pictures as animation steps, the Tile tab |
 | [Tilemaps](Tilemaps) | The tilemap asset, painting in the scene view, layers, what it looks like in the game |
 | [State machines](State-machines) | The state machine asset, its scope, named transitions, the start state, `State branch` and its `else`, `Set state`, `Set state by name`, `State transition`, the two state events and the live highlight |
-| [Shaders](Shaders) | The shader asset, the Shader tab, the node set, the Adjust colors recipe, wearing a shader |
+| [Shaders](Shaders) | The shader asset, the Shader tab, the node set, the Adjust colors recipe, passes, shader functions, wearing a shader on a sprite, a text, a particle field or a camera |
 | [Particles](Particles) | The particles asset, a particle as a formula of its age, the source's rows, the Particles tab |
 | [Containers](Containers) | Editing a template, instances and their edits, screens without scene switching |
 | [Keyboard](Keyboard) | Every shortcut |
@@ -48,8 +50,7 @@ into issues #1-#50, closed ones included, each carrying the commits it was filed
 ## Not yet
 
 A touch-optimised layout. Sound has no mixer, no fade and no
-`Set volume` on a playing voice (see [Sounds](Sounds)). A frame is always stretched to
-the sprite's `width` x `height`: no nine-slice. Animations have no events on the
+`Set volume` on a playing voice (see [Sounds](Sounds)). Animations have no events on the
 timeline and no preview in the Scene tab. Slicing cuts a regular grid only — no detection of where the sprites actually
 sit on the sheet. Unreferenced image files are never collected — deliberately, since the image
 picker offers them again; nothing deletes a stored image except `DELETE ?r=textures/{file}`, which