station-master-startos/startos/versions/current.ts

import { IMPOSSIBLE, VersionInfo } from '@start9labs/start-sdk'

export const current = VersionInfo.of({
  // `<upstream>:<downstream>` — the upstream half tracks the bundled Station Master tag exactly
  // (`versions.md`'s consistency checklist), so bumping the submodule pin and bumping this are one
  // action. The downstream half moves only for packaging-only changes, and RESETS to `:0` when the
  // upstream half moves.
  //
  // FOUR COMPONENTS IS FINE. ExVer's upstream half is an arbitrary-length dotted number, not semver
  // — checked against the SDK's own parser rather than assumed, since every example in `versions.md`
  // has three: `0.7.9.8:0` parses to upstream `[0,7,9,8]`, which sorts above `[0,7,9]`, so a box on
  // 0.7.9:0 sees this as an update rather than refusing it as a downgrade.
  version: '0.8.0:0',
  releaseNotes: {
    en_US:
      'Bundles Station Master v0.8.0 — you can watch the other players now. GAMES IN PROGRESS ON ' +
      'THIS SERVER ARE UNAFFECTED and will resume normally. Until now another player could move a ' +
      'train the length of their district and the only trace on your screen was a line of text: your ' +
      'board showed your own Office Area and nobody else’s, and a bot’s whole turn arrived as a ' +
      'position that had simply changed. Now every move is replayed on your screen in the order it ' +
      'happened. The Office Area follows whoever is acting, so you watch their switching moves step ' +
      'across their board — which is the part worth seeing, and the part reading the history could ' +
      'never convey. A row above the board says how many moves behind you are and counts down, with ' +
      'a Skip button when you would rather not wait; nothing is lost by skipping, since every line ' +
      'is already in the History panel. The automatic phases — New Train, the Mainline, the shift ' +
      'change — used to resolve between one click and the next without ever being drawn, and now ' +
      'take a visible beat when something happens in them and none at all when nothing does. ' +
      'Switching moves in the history finally say who made them and name the train, instead of ' +
      'reading as an anonymous “CREW moved”. Playback speed is a per-player setting and can be ' +
      'turned off entirely.',
    es_ES:
      'Incluye Station Master v0.8.0 — ahora puedes ver jugar a los demás. LAS PARTIDAS EN CURSO EN ' +
      'ESTE SERVIDOR NO SE VEN AFECTADAS y se reanudarán con normalidad. Hasta ahora otro jugador ' +
      'podía mover un tren a lo largo de todo su distrito y el único rastro en tu pantalla era una ' +
      'línea de texto: tu tablero mostraba tu propia Área de Oficina y la de nadie más, y el turno ' +
      'completo de un bot llegaba como una posición que simplemente había cambiado. Ahora cada ' +
      'movimiento se reproduce en tu pantalla en el orden en que ocurrió. El Área de Oficina sigue a ' +
      'quien está jugando, así que ves sus maniobras avanzar por su tablero, que es lo que merece la ' +
      'pena ver y lo que el historial nunca podía transmitir. Una fila sobre el tablero indica ' +
      'cuántos movimientos llevas de retraso y va descontando, con un botón Saltar por si prefieres ' +
      'no esperar; no se pierde nada al saltar, porque cada línea ya está en el panel de Historial. ' +
      'Las fases automáticas — Tren Nuevo, la Línea Principal, el cambio de turno — se resolvían ' +
      'entre un clic y el siguiente sin dibujarse nunca, y ahora tienen una pausa visible cuando algo ' +
      'ocurre en ellas y ninguna cuando no ocurre nada. Las maniobras en el historial por fin dicen ' +
      'quién las hizo y nombran el tren, en lugar de leerse como un anónimo «CREW moved». La ' +
      'velocidad de reproducción es un ajuste por jugador y se puede desactivar por completo.',
    de_DE:
      'Enthält Station Master v0.8.0 — Sie können den anderen jetzt beim Spielen zusehen. LAUFENDE ' +
      'PARTIEN AUF DIESEM SERVER SIND NICHT BETROFFEN und werden normal fortgesetzt. Bisher konnte ' +
      'ein anderer Spieler einen Zug durch sein ganzes Revier bewegen, und die einzige Spur auf ' +
      'Ihrem Bildschirm war eine Textzeile: Ihr Brett zeigte nur Ihren eigenen Dienstbereich und den ' +
      'von niemandem sonst, und der komplette Zug eines Bots erschien als eine Stellung, die sich ' +
      'einfach geändert hatte. Jetzt wird jeder Zug auf Ihrem Bildschirm in der Reihenfolge ' +
      'wiedergegeben, in der er geschah. Der Dienstbereich folgt demjenigen, der am Zug ist, sodass ' +
      'Sie seine Rangierbewegungen über sein Brett wandern sehen — das ist der sehenswerte Teil und ' +
      'der, den das Protokoll nie vermitteln konnte. Eine Zeile über dem Brett zeigt, wie viele Züge ' +
      'Sie im Rückstand sind, und zählt herunter, mit einer Überspringen-Schaltfläche, wenn Sie ' +
      'nicht warten möchten; dabei geht nichts verloren, denn jede Zeile steht schon im Protokoll. ' +
      'Die automatischen Phasen — Neuer Zug, die Hauptstrecke, der Schichtwechsel — liefen zwischen ' +
      'einem Klick und dem nächsten ab, ohne je gezeichnet zu werden, und halten nun sichtbar inne, ' +
      'wenn darin etwas passiert, und gar nicht, wenn nichts passiert. Rangierbewegungen im ' +
      'Protokoll nennen endlich den Spieler und den Zug, statt als anonymes „CREW moved“ zu ' +
      'erscheinen. Die Wiedergabegeschwindigkeit ist eine Einstellung pro Spieler und lässt sich ' +
      'ganz abschalten.',
    pl_PL:
      'Zawiera Station Master v0.8.0 — teraz możesz obserwować grę pozostałych. TRWAJĄCE PARTIE NA ' +
      'TYM SERWERZE NIE SĄ NARUSZONE i zostaną normalnie wznowione. Do tej pory inny gracz mógł ' +
      'przeprowadzić pociąg przez cały swój okręg, a jedynym śladem na twoim ekranie była linijka ' +
      'tekstu: twoja plansza pokazywała wyłącznie twój własny Obszar Biura i niczyj inny, a cała ' +
      'tura bota pojawiała się jako pozycja, która po prostu się zmieniła. Teraz każdy ruch jest ' +
      'odtwarzany na twoim ekranie w kolejności, w jakiej nastąpił. Obszar Biura podąża za tym, kto ' +
      'wykonuje ruch, więc widzisz, jak jego manewry przesuwają się po jego planszy — a to właśnie ' +
      'warto zobaczyć i tego historia nigdy nie potrafiła przekazać. Wiersz nad planszą pokazuje, o ' +
      'ile ruchów jesteś z tyłu, i odlicza, z przyciskiem Pomiń, jeśli wolisz nie czekać; pominięcie ' +
      'nic nie kosztuje, bo każda linijka jest już w panelu Historii. Fazy automatyczne — Nowy ' +
      'Pociąg, Linia Główna, zmiana warty — rozstrzygały się między jednym kliknięciem a drugim, ' +
      'nigdy nie będąc narysowane, a teraz zatrzymują się na widoczną chwilę, gdy coś się w nich ' +
      'dzieje, i wcale, gdy nic się nie dzieje. Manewry w historii wreszcie mówią, kto je wykonał, i ' +
      'nazywają pociąg, zamiast brzmieć jak anonimowe „CREW moved”. Szybkość odtwarzania jest ' +
      'ustawieniem dla każdego gracza osobno i można ją całkiem wyłączyć.',
    fr_FR:
      'Contient Station Master v0.8.0 — vous pouvez maintenant regarder jouer les autres. LES ' +
      'PARTIES EN COURS SUR CE SERVEUR NE SONT PAS AFFECTÉES et reprendront normalement. Jusqu’ici ' +
      'un autre joueur pouvait déplacer un train sur toute la longueur de son district et la seule ' +
      'trace sur votre écran était une ligne de texte : votre plateau ne montrait que votre propre ' +
      'Zone de Bureau et celle de personne d’autre, et le tour entier d’un bot arrivait comme une ' +
      'position qui avait simplement changé. Désormais chaque coup est rejoué sur votre écran dans ' +
      'l’ordre où il a eu lieu. La Zone de Bureau suit celui qui joue, si bien que vous voyez ses ' +
      'manœuvres progresser sur son plateau — c’est la partie qui vaut d’être vue, et celle que lire ' +
      'l’historique ne pouvait jamais rendre. Une ligne au-dessus du plateau indique de combien de ' +
      'coups vous êtes en retard et décompte, avec un bouton Passer si vous préférez ne pas ' +
      'attendre ; rien n’est perdu en passant, puisque chaque ligne est déjà dans le panneau ' +
      'Historique. Les phases automatiques — Nouveau Train, la Grande Ligne, la relève — se ' +
      'résolvaient entre un clic et le suivant sans jamais être dessinées, et marquent maintenant un ' +
      'temps visible quand quelque chose s’y produit, et aucun quand rien ne s’y produit. Les ' +
      'manœuvres dans l’historique disent enfin qui les a faites et nomment le train, au lieu de se ' +
      'lire comme un « CREW moved » anonyme. La vitesse de relecture est un réglage par joueur et ' +
      'peut être entièrement désactivée.',
  },
  migrations: {
    /**
     * NOTHING TO CARRY, AND CHECKED THE SAME NARROW WAY v0.7.9.8's ENTRY WAS.
     *
     * The rule this package lives by is in the game's README: a save is a seed plus the moves
     * played, replayed through the CURRENT rules, so the only thing that strands an older save is a
     * change that makes a once-legal move illegal. So the question is never "how big was the
     * release" — v0.8.0 is a large one — but "did any predicate change its answer".
     *
     * Measured with `git diff v0.7.9.8..v0.8.0 -- src/engine/`. The WHOLE engine diff is eight lines:
     * four `GameEvent` types (`trayMoved`, `carsCoupled`, `carsDropped`, `consistSorted`) gained a
     * `player` field, and the four places that build them pass it. `check()` is untouched, `legal.ts`
     * and `advance.ts` are untouched, and no predicate anywhere was edited. Games in progress resume,
     * and the release notes say so in all five locales rather than leaving it to be discovered.
     *
     * EVENTS ARE NOT PERSISTED, so widening four of them cannot invalidate anything on disk: a
     * `SavedGame` is `{ seed, config, history: Intent[], … }` and the events are derived by replaying
     * it. The narration TEXT of two lines changed with them ("Moved Train 3 …" where it used to read
     * "CREW moved …"), which a resumed game simply regenerates — the log is not stored either.
     *
     * WHAT IS NOT COVERED BY THAT ARGUMENT, and why it still does not need a migration: the wire
     * between this server and a browser gained a lot. `Push` now carries ordered presentation steps
     * and a public-board baseline, and the board deltas changed shape. None of it is on disk, and a
     * browser reloads onto the new page as part of the update, so there is no version skew to
     * migrate — the same reasoning v0.7.9.8 used for its own `Frame` changes.
     *
     * THE ONE THING THAT WOULD HAVE NEEDED CARE, had it been built the way the plan first described:
     * the display-step collector runs inside `submit()`, and the resume path (`fromMultiplayerSave`)
     * deliberately does not go through `submit()`. So replaying a saved game emits no steps and burns
     * no sequence numbers. A test in the game pins that, because it is a property rather than an
     * accident.
     */
    up: async ({ effects }) => {},
    down: IMPOSSIBLE,
  },
})