Repository navigation
v3.0.0 — the escapement becomes a socket
The escapement stops being one module and becomes a socket holding one of
several. The app now opens with a plain Swiss lever escapement; a tourbillon
can be installed in its place, and a double-axis tourbillon is shown as the
next step without pretending to exist.
The point is not configurability. It is that one function can be filled by
units of wildly different complexity — and that in this model the extra
complexity buys nothing. Swapping the escapement in front of the viewer moves
no number on the station card, because the card now shows only what a swap
cannot move. That is the strongest statement of the station's own claim: the
rate is set by the balance, not by the construction.
What the model can show honestly is the cost — and it measures it rather
than claiming it.
| parts | of them moving | nested rotations | footprint | |
|---|---|---|---|---|
| Lever escapement | 18 | 16 | 1 | 4.73 × 2.95 |
| Tourbillon | 50 | 48 | 2 | 4.32 × 5.20 |
| Double-axis tourbillon | — | — | — | — |
Every figure comes from walking that module's own scene graph. The planned
module has none, because there is nothing to walk yet and inventing them would
break the rule the rest of the app lives by.
One result worth stating plainly: the lever's footprint is wider. Its
balance is carried out to one side while the cage keeps everything inside its
rim. The cost of complexity shows in part count, in how much of it moves, in
nesting and in height — not in width. A test pins that, so it does not get
tidied into a neater story later.
What is in it
- The socket. All modules are built at startup, exactly one is installed,
and only the installed one is updated. A module hands the socket a rotating
group, a fixed group andupdate() → β; how many nested cages it has, and
about which axes, is its own business — which is what lets a double-axis
module arrive later without touching the socket. - The lever escapement, restored from v0.5.0 (the tourbillon had deleted
it) and adapted to the current contract. The parts swap places: in a
tourbillon the balance is central and the escape wheel orbits; in a lever the
escape wheel is central — the train drives it directly — and the balance
moves out to that same 2.6. - The Варіанти modal on station 4: three modules with silhouettes, the cost
table, one honesty line, Лишити як є / Змінити. The mechanism keeps running
while it is open — pausing would break the very thing being shown — and the
camera flies to the escapement after a change. - The beat maths lives once. It had already been copy-pasted verbatim
between v0.5.0's escapement and the tourbillon — same constants, same
smoothstep. Identical timing across modules is now structural rather than a
rule someone has to remember.
Fixed along the way
- Units were never translated. "12 с" stayed Cyrillic in English: the unit
was written intostations.jsrather than the dictionary, and key parity
cannot see a string that never reaches one. - "seconds wheel" contradicted "Fourth wheel" — the same part named two
ways, which the project's own notes warn about specifically.
Both predate this release.
How it was verified
Stage one of the branch was a pure refactor, and every commit in it was checked
by a scene-graph diff against main — the world transform of every mesh
across idle, demo, manual wind and auto-wind. 704 meshes, zero differences.
That is how a crown-spin regression was caught once before, when the test suite
alone had missed it.
89 tests, up from 68. Six of them carry the premise directly: exactly one
module installed, visible and updated; identical β across modules; the
station's figures unchanged whichever is installed; the cost metrics derived
rather than typed — checked by rebuilding the socket with a different cage
radius and watching the measurement follow.