Files
galaxy-game/ui/frontend/src/proto/galaxy/fbs/user/active-sanction.ts
T
Ilia Denisov 969c0480ba ui/phase-27: battle viewer (radial scene, playback, map markers)
Engine wire change: Report.battle switched from []uuid.UUID to
[]BattleSummary{id, planet, shots} so the map can place battle
markers without N extra fetches. FBS schema + generated Go/TS
regenerated; transcoder + report controller updated; openapi
adds the BattleSummary schema with a freeze test.

Backend gateway forwards engine GET /api/v1/battle/:turn/:uuid as
/api/v1/user/games/{game_id}/battles/{turn}/{battle_id} (handler
plus engineclient.FetchBattle, contract test stub, openapi spec).

UI:
- BattleViewer (lib/battle-player/) is a logically isolated SVG
  radial scene that consumes a BattleReport prop. Planet at the
  centre, races on the outer ring at equal angular spacing, race
  clusters by (race, className) with <class>:<numLeft> labels;
  observer groups (inBattle: false) are not drawn; eliminated
  races drop out and survivors re-distribute on the next frame.
- Shot line per frame: red on destroyed, green otherwise; erased
  on the next frame. Playback controls: play/pause + step ± +
  rewind + 1x/2x/4x speed (400/200/100 ms per frame).
- Page wrapper (lib/active-view/battle.svelte) loads BattleReport
  via api/battle-fetch.ts; synthetic-gameId prefix routes to a
  fixture loader, otherwise REST through the gateway. Always-
  visible <ol> text protocol satisfies the accessibility ask.
- section-battles.svelte links every battle UUID into the viewer.
- map/battle-markers.ts: yellow X cross of 2 LinePrim through the
  corners of the planet's circumscribed square (stroke width
  clamps from 1 px at 1 shot to 5 px at 100+ shots); bombing
  marker is a stroke-only ring (yellow when damaged, red when
  wiped). Wired into state-binding.ts; click handler dispatches
  battle clicks to the viewer and bombing clicks to the matching
  Reports row.
- i18n keys for the viewer in en + ru.

Docs: ui/docs/battle-viewer-ux.md, FUNCTIONAL.md §6.5 + ru
mirror, ui/PLAN.md Phase 27 decisions + deferred TODOs (push
event, richer class visuals, animated re-distribution).

Tests: Vitest unit (radial layout + timeline frame builder +
marker stroke formula + marker primitives), Playwright e2e for
the viewer (Reports link → viewer, playback step, not-found),
backend engineclient FetchBattle (200 / 404 / bad input), engine
openapi freezes (BattleReport, BattleReportGroup,
BattleActionReport, BattleSummary, Report.battle items).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-13 12:24:20 +02:00

148 lines
5.1 KiB
TypeScript

// automatically generated by the FlatBuffers compiler, do not modify
/* eslint-disable @typescript-eslint/no-unused-vars, @typescript-eslint/no-explicit-any, @typescript-eslint/no-non-null-assertion */
import * as flatbuffers from 'flatbuffers';
import { ActorRef, ActorRefT } from '../user/actor-ref.js';
export class ActiveSanction implements flatbuffers.IUnpackableObject<ActiveSanctionT> {
bb: flatbuffers.ByteBuffer|null = null;
bb_pos = 0;
__init(i:number, bb:flatbuffers.ByteBuffer):ActiveSanction {
this.bb_pos = i;
this.bb = bb;
return this;
}
static getRootAsActiveSanction(bb:flatbuffers.ByteBuffer, obj?:ActiveSanction):ActiveSanction {
return (obj || new ActiveSanction()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
}
static getSizePrefixedRootAsActiveSanction(bb:flatbuffers.ByteBuffer, obj?:ActiveSanction):ActiveSanction {
bb.setPosition(bb.position() + flatbuffers.SIZE_PREFIX_LENGTH);
return (obj || new ActiveSanction()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
}
sanctionCode():string|null
sanctionCode(optionalEncoding:flatbuffers.Encoding):string|Uint8Array|null
sanctionCode(optionalEncoding?:any):string|Uint8Array|null {
const offset = this.bb!.__offset(this.bb_pos, 4);
return offset ? this.bb!.__string(this.bb_pos + offset, optionalEncoding) : null;
}
scope():string|null
scope(optionalEncoding:flatbuffers.Encoding):string|Uint8Array|null
scope(optionalEncoding?:any):string|Uint8Array|null {
const offset = this.bb!.__offset(this.bb_pos, 6);
return offset ? this.bb!.__string(this.bb_pos + offset, optionalEncoding) : null;
}
reasonCode():string|null
reasonCode(optionalEncoding:flatbuffers.Encoding):string|Uint8Array|null
reasonCode(optionalEncoding?:any):string|Uint8Array|null {
const offset = this.bb!.__offset(this.bb_pos, 8);
return offset ? this.bb!.__string(this.bb_pos + offset, optionalEncoding) : null;
}
actor(obj?:ActorRef):ActorRef|null {
const offset = this.bb!.__offset(this.bb_pos, 10);
return offset ? (obj || new ActorRef()).__init(this.bb!.__indirect(this.bb_pos + offset), this.bb!) : null;
}
appliedAtMs():bigint {
const offset = this.bb!.__offset(this.bb_pos, 12);
return offset ? this.bb!.readInt64(this.bb_pos + offset) : BigInt('0');
}
expiresAtMs():bigint {
const offset = this.bb!.__offset(this.bb_pos, 14);
return offset ? this.bb!.readInt64(this.bb_pos + offset) : BigInt('0');
}
static startActiveSanction(builder:flatbuffers.Builder) {
builder.startObject(6);
}
static addSanctionCode(builder:flatbuffers.Builder, sanctionCodeOffset:flatbuffers.Offset) {
builder.addFieldOffset(0, sanctionCodeOffset, 0);
}
static addScope(builder:flatbuffers.Builder, scopeOffset:flatbuffers.Offset) {
builder.addFieldOffset(1, scopeOffset, 0);
}
static addReasonCode(builder:flatbuffers.Builder, reasonCodeOffset:flatbuffers.Offset) {
builder.addFieldOffset(2, reasonCodeOffset, 0);
}
static addActor(builder:flatbuffers.Builder, actorOffset:flatbuffers.Offset) {
builder.addFieldOffset(3, actorOffset, 0);
}
static addAppliedAtMs(builder:flatbuffers.Builder, appliedAtMs:bigint) {
builder.addFieldInt64(4, appliedAtMs, BigInt('0'));
}
static addExpiresAtMs(builder:flatbuffers.Builder, expiresAtMs:bigint) {
builder.addFieldInt64(5, expiresAtMs, BigInt('0'));
}
static endActiveSanction(builder:flatbuffers.Builder):flatbuffers.Offset {
const offset = builder.endObject();
return offset;
}
unpack(): ActiveSanctionT {
return new ActiveSanctionT(
this.sanctionCode(),
this.scope(),
this.reasonCode(),
(this.actor() !== null ? this.actor()!.unpack() : null),
this.appliedAtMs(),
this.expiresAtMs()
);
}
unpackTo(_o: ActiveSanctionT): void {
_o.sanctionCode = this.sanctionCode();
_o.scope = this.scope();
_o.reasonCode = this.reasonCode();
_o.actor = (this.actor() !== null ? this.actor()!.unpack() : null);
_o.appliedAtMs = this.appliedAtMs();
_o.expiresAtMs = this.expiresAtMs();
}
}
export class ActiveSanctionT implements flatbuffers.IGeneratedObject {
constructor(
public sanctionCode: string|Uint8Array|null = null,
public scope: string|Uint8Array|null = null,
public reasonCode: string|Uint8Array|null = null,
public actor: ActorRefT|null = null,
public appliedAtMs: bigint = BigInt('0'),
public expiresAtMs: bigint = BigInt('0')
){}
pack(builder:flatbuffers.Builder): flatbuffers.Offset {
const sanctionCode = (this.sanctionCode !== null ? builder.createString(this.sanctionCode!) : 0);
const scope = (this.scope !== null ? builder.createString(this.scope!) : 0);
const reasonCode = (this.reasonCode !== null ? builder.createString(this.reasonCode!) : 0);
const actor = (this.actor !== null ? this.actor!.pack(builder) : 0);
ActiveSanction.startActiveSanction(builder);
ActiveSanction.addSanctionCode(builder, sanctionCode);
ActiveSanction.addScope(builder, scope);
ActiveSanction.addReasonCode(builder, reasonCode);
ActiveSanction.addActor(builder, actor);
ActiveSanction.addAppliedAtMs(builder, this.appliedAtMs);
ActiveSanction.addExpiresAtMs(builder, this.expiresAtMs);
return ActiveSanction.endActiveSanction(builder);
}
}