Architecture
MelekTaus edited this page 2026-10-18 11:09:00 +02:00
Clone

Wiki Page Revisions

166 Commits

Author SHA1 Message Date
admin bfbab14701 Let the mouse nodes look through a camera (#304)
- Behaviors (Mouse) and Concepts explain the new camera input of
  Mouse position and Is hovered.
- Architecture names pointerThrough.
- Development counts 1730 e2e checks.
2026-10-03 19:10:13 +02:00
adminandClaude Opus 5.5 30c94a3ffe Note how an input and an output share a node row (#306)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 18:33:17 +02:00
admin 996b5841af Bring Home and Architecture up to date (#85) 2026-10-03 17:38:49 +02:00
admin e3775c2ae9 Describe render layers and overlay cameras (#302)
- Concepts: a section on render layers, Sees and Overlay, and why z
  never sorts across cameras.
- API: the fields renderLayers, renderLayer, sees and overlay.
- Architecture: renderLayers in the model, the overlay views in
  WorldViewport.
- Development: e2e total 1720.
2026-10-03 15:33:09 +02:00
admin c657f2a9a2 Concepts: the editor remembers where each divider was dragged
Concepts names the dividers that are kept and says the sizes belong to the browser, not the project. Architecture names editor/panelSizes.ts. Development counts 1692 editor checks.
2026-10-02 23:24:30 +02:00
admin 0665b682e2 Physics: joints tie two objects together (#154)
Physics has a new section Joints for the hinge, the spring, the rope and the fixed joint. Concepts, Behaviors and Architecture name the new asset type and the node Add joint. Development counts 1691 e2e checks.
2026-10-02 21:43:18 +02:00
admin d554dfddbf Describe flow ports at Start and End and the On behavior node (#294) 2026-10-02 19:33:39 +02:00
admin f8ee57b6ff Link zoom of the released game: Auto or Fit (#279) 2026-10-02 13:53:16 +02:00
admin 09d1f978ac Vector Art: no warning from a redrawn picture, no Add shape (#293)
Architecture says when a replaced picture is freed while a shader still names it, Vector Art drops the Add shape button, Development carries the sum of 1668 e2e checks.
2026-10-02 13:03:58 +02:00
admin 82a952c04b Tooltips: what a button without words says on hover (#209)
Architecture has the paragraph on the tooltip layer and its rule, Concepts names the tooltips of the top bar, Development carries the sum of 1667 e2e checks.
2026-10-02 12:03:03 +02:00
admin 4ff5495274 Architecture, Development: a large graph is moved, not drawn again (#292) 2026-10-02 10:18:25 +02:00
admin f59d7604bf Architecture, Development: text and boxes on device pixels
- Architecture: how the toolkit puts text and boxes on device
  pixels (crispText, crisp, hairline, the nudge of the stage), and
  what it does not give (subpixel smoothing).
- Development: the run is at 100 %, step 62 alone runs at 150 %.
  The hooks that read the frame as the screen gets it, and the
  deviceScaleFactor option of the harness. The sum is 1656.

Belongs to 32a0af6 in the main repository.
2026-10-02 08:42:34 +02:00
admin 6e8426cb0e Describe the bands that head the groups of the inspector (#290)
Concepts has the groups, the fold and where it is remembered. Architecture names the bricks in the toolkit, Scenes says where the switch sits now, Development has the new sum of e2e checks.
2026-10-01 22:08:34 +02:00
admin b2d413bd60 Document Keep on scene load (#165)
- Scenes: new section on the switch, what travels, the duplicate rules
  and what does not travel. Load scene builds a scene as it is stored.
- Architecture: how a kept entity moves into the next world, and that
  a run keeps what each scene stored before it built it.
- Concepts and Sounds: one sentence each on kept objects.
- Development: the e2e sum is 1625.
2026-10-01 17:30:22 +02:00
admin 6b01dae9ca Describe per-frame previews of inspector rows and tabs (#274)
- Architecture: inspector rows and colour stops preview once per
  frame, with the measured numbers. The Pixel art tab's side panel
  and the Curve tab's fields follow the same rule.
- Development: 1616 editor checks.
2026-10-01 12:02:21 +02:00
admin 9d9e73e243 Describe how the run is written into the model (#287)
Architecture: syncToModel compares each entity with what the model
last said instead of resolving every object in every frame, with the
contract behind it and the measured numbers.
2026-10-01 10:28:01 +02:00
adminandClaude Opus 5.5 5952fa0bd0 Explain typed writes at runtime and the typed List node (#271)
- Structs: new section A typed List node, In the running game split
  into lists and struct variables, and Under the hood for the check.
- Architecture: typedValues and what lookup tells a port.
- Development: e2e total 1606.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 22:08:33 +02:00
admin 0b54e14387 Say the editor loads no bold face and why the test checks it (#273)
- Architecture: Source Sans 3 in 400, 500 and 600.
- Development: the font test holds the loaded weights to the
  fontWeight settings in src/ both ways.
2026-09-30 21:27:58 +02:00
adminandClaude Opus 5.5 442ad12097 Say that only the owner deletes a project (#272)
The API now answers an administrator 403 when they delete somebody
else's project. The pages still said an administrator deletes every
project like their own.

- API: the DELETE row names the 403, and the paragraph on
  administrators says deleting stays with the owner.
- Accounts: the list of what an administrator may do, and the Delete
  row of the user management.
- Architecture: one line on what `seesAll` covers.
- Development: the e2e total, 1602 to 1603.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 21:13:31 +02:00
adminandClaude Opus 5.5 6413fa595f Explain the possible frame rate in the performance overlay (#275)
- Concepts: what the Possible line shows and why it is an upper bound
- Architecture: how possibleFps is computed
- Development: the e2e total is 1602

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 11:18:46 +02:00
admin 9d65087c79 Explain the performance overlay in the Game View (#275)
- Concepts: new paragraph Performance with a table of what each line
  counts.
- Architecture: how the frame is measured, and that Chromium rounds
  performance.now() to 0.1 ms. The mean over about 30 frames smooths
  that out.
- Development: the e2e total is now 1601.
2026-09-30 09:45:07 +02:00
adminandClaude Opus 5.5 7995918921 Document admin-only deletes, file modes and Esc as Cancel (#85)
Brings the pages in line with refactoring round 8 of the code.

- API: deleting an image, font or sound is for administrators only, a
  bad upload answers 422, private files are 0640 and the web server
  answers 403 for them, and saves take turns on a lock file. The line
  that said there was no authentication yet is gone.
- Home: the "Not yet" list named several scenes in one run, auth and
  graph comments and groups, which all exist.
- Concepts, Keyboard, Vector art: Escape on a question is its Cancel,
  deleting a project leads back to the picker, and Delete removes
  shapes picked in the list.
- Architecture: AtomicFile, routeFiles, HashedFileStore, the lock
  file, removeSelection and removeShapes, objectName and groupName,
  and the Escape of a Dialog.
- Development: the check sum, and the race check in
  accounts.test.php needs pcntl.
- Eight pages lose the 38 characters Gitea flagged as ambiguous, and
  quoted labels follow the editor's American spelling.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 18:13:11 +02:00
adminandClaude Opus 5.5 496a2118b9 List the modules from refactoring round 7 in Architecture (#85)
Architecture names the files and helpers the round added, so the page
matches the code again.

- BehaviorSystem is followed by behaviorPulses and behaviorContext.
- pointGrips and PointKindButton sit with the polygon edit helpers.
- vec names the cubic at t and its split, Properties names mapNested
  and the struct field helpers.
- The store line names jsonBody and staleRevision.
- The viewport tools name selectedItem.
- The line on markIcons describes the current state, not history.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 16:17:17 +02:00
admin bfc26ec71f Describe the fullscreen game view (#267)
Concepts gets a Fullscreen section and a sentence under Release. Architecture lists fullscreen.ts and FullscreenCorner.ts. Development has the new e2e module 61 and the sum of 1580 checks.
2026-09-29 14:44:30 +02:00
adminandClaude Opus 5.5 d0ed6bd81d Describe the game link and the new zoom steps (#266)
A project can now be released as a link that plays without the
editor and without a login.

- Concepts: a Release section, the new main menu entry and the zoom
  steps 300%, 500% and 600% in the game tab table.
- API: the four release routes, and that the public one is the only
  route besides auth that needs no session.
- Architecture: GameRun, the player page, gamePointer, projectFiles
  and WorldViewport in its new place under src/viewport.
- Development: the PHP release test and the measured sum of 1574
  e2e checks.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 14:15:11 +02:00
adminandClaude Opus 5.5 a045c4a186 Describe the event order and the Order field (#264)
- Behaviors: new section Event order. A frame runs event kind by
  event kind, Order sorts within a kind, ties go by hierarchy and
  then creation order. The lifecycle sentence on destroying is fixed.
- Architecture: names core/graph/eventOrder.ts.
- Development: the e2e total is 1551, measured.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 09:21:42 +02:00
adminandClaude Opus 5.5 c86b7ba50e Describe clip areas and On mouse wheel (#260)
- Concepts explains the clip area.
- Behaviors lists On mouse wheel and the type Clip area at the
  Properties node.
- Architecture names clip.ts.
- Development has the check sum 1549.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 07:08:15 +02:00
admin 2a1ce85981 Add the Structs page for struct assets (#253)
New page Structs with sidebar entry. Behaviors, Architecture and Development point to it. Check total 1500.
2026-09-28 06:04:49 +02:00
admin 40027db357 Describe inline lists and the Variables tab, 1486 editor checks (#252) 2026-09-27 21:56:30 +02:00
admin b0318cde16 Describe curve assets (#247)
New page Curves with the tab, the rules and the presets, plus the Curve option in Animations and Behaviors, the model in Architecture and the check sum 1472 in Development.
2026-09-27 15:58:11 +02:00
adminandClaude Opus 5.5 82dd9f1b77 Describe the scene tab header and Fit on the camera (#245)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-27 12:58:01 +02:00
adminandClaude Opus 5.5 2b694379c3 Describe groups in the scene hierarchy (#241)
- Scene editing: new section "Groups in the hierarchy", plus the click
  on an object that is already selected with others.
- Architecture: group model, treeOrder and the drop rules.
- Development: check sum 1442.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-27 01:18:05 +02:00
adminandClaude Opus 5.5 79c3b3ef53 Describe copy and paste of objects and nodes (#240)
- Scene editing: new section on Ctrl+C/Ctrl+V, where a paste lands
  and under which parent.
- Behaviors: a point on copying nodes and what the palette filter
  leaves out.
- Keyboard: Ctrl+C/Ctrl+V per tab and the picture import.
- Architecture: clipboard snapshot and paste commands.
- Development: e2e check total 1432.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-27 00:25:59 +02:00
admin 13fef2957a Describe the eye popup for scene view visibility
Scene editing explains the Symbol, Name and Shape toggles per asset kind, Architecture lists the new topbar button, Development raises the check count to 1422.
2026-09-26 23:33:11 +02:00
admin 0e42e2fecb Describe project snapshots and their API routes (#231)
The editor can now keep named snapshots of a project. The wiki
explains how to use them and where they live.

- Concepts: new section "Snapshots" on create, restore with the
  automatic "Before restoring" copy, and delete.
- API: the four routes under projects/{id}/snapshots.
- Architecture: SnapshotStore on server and client, and the dialog.
- Development: e2e module 50, the PHP test and the check sum 1393.
2026-09-25 18:22:07 +02:00
adminandClaude Opus 5.5 010259abb3 Describe the tilemap memo and what it saves per frame
Tilemaps gets the measurements under The cost of outlined cells. Architecture lists tilemapMemo in the model modules.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 12:23:33 +02:00
admin daeeaf9fe8 Describe sorting by Y, the tile sort offset and the frame sort line (#228) 2026-09-24 19:34:44 +02:00
admin 424bf6fcd6 Keep play start and game view scale in the project (#226) 2026-09-24 11:38:29 +02:00
admin 87573181f0 Describe the two drawing layers of the texture tab (#220)
Architecture explains the sheet and overlay layers, the pan without rebuild and the measured times. Development has the new check total 1336.
2026-09-23 15:57:28 +02:00
adminandClaude Opus 5.5 3af598d40e Describe roles and the user management tab (#180, #179)
- Accounts: roles, the User management tab, the account table and the
  role argument of make-user.php.
- API: the users routes and how admins reach other users' projects.
- Concepts, Plugins, Architecture: the shared closable tab.
- Development: check sum 1333.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 13:59:23 +02:00
admin 314c09ef50 Describe the per-frame drag preview (#213) 2026-09-23 11:08:31 +02:00
admin 1fbbc42ae8 Describe the split of the four largest files (#215) 2026-09-23 10:20:24 +02:00
admin fa9e6a5540 Describe the 500 weight and the SVG icons (#214)
- Architecture: fonts load 400, 500, 600 and 700. Icons, markIcons and
  the chevron are described.
- Development: tests find icons through __gm.locateIcons(id).
- Behaviors, Scenes, Sounds: kind, scene and sound marks are described
  instead of written as glyphs.
- Development: editor-suite check sum 1312.
2026-09-23 08:13:41 +02:00
adminandClaude Opus 5.5 db8b6428d3 Architecture catches up with refactoring round 6 (#85)
- Architecture names SheetCanvas, mixColor, fingerprint, MoveCommand
  and rayOf, plus seven modules that were missing, among them
  vectorCurves, portTypes, SortableList and PixelThumbs. The Scope
  entry is current again after #164.
- Scene editing no longer points to symbol-icons.test.ts, which went
  into svg-icons.test.ts with #176.
- Development: the editor check sum is 1310. CI measured 1308 at
  d7c0b7c, plus the two new pan checks.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 06:58:00 +02:00
adminandClaude Opus 5 7cdee566eb Architecture: a pan only moves the camera
- Architecture names moveCamera and when a pan still takes the full
  redraw.
- Development: check total 1285.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-22 15:38:17 +02:00
admin 2df61ba4e5 Pixel art: options per tool, full-width palette, remove any colour (#201)
Pixel Art, Architecture and Development pages follow the change.
2026-09-22 11:58:38 +02:00
admin a1c77c76c6 Describe persistent Variables assets and clearing saved data (#166) 2026-09-22 10:24:03 +02:00
admin d63d71d1a1 Add the Pixel Art page and link it from the other pages (#130)
New page Pixel Art. Sidebar, Home, API, Architecture, Textures, Tiles and Development are updated, the check total is 1259.
2026-09-21 17:33:51 +02:00
admin a726d4a907 Document gradient and texture fills in Vector Art (#186)
- Vector Art gets the section "Gradients and textures" with the paint
  types and the handles of the Paint tool. Toolbar, inspector,
  combining and known limits are updated.
- Architecture names vectorPaint and the gradient bar.
- Development carries the check sum 1232.
2026-09-21 13:05:05 +02:00
adminandClaude Opus 5 b07676cb23 Document combining vector shapes (#187)
- Vector Art: new section Combining shapes with a table, Ctrl+click,
  Delete on several shapes, the COMBINE block and a known limit.
- Architecture: Clipper2 in the stack and the vectorBoolean module.
- Development: check sum 1222.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-21 11:56:41 +02:00