104 lines
2.1 KiB
TypeScript
104 lines
2.1 KiB
TypeScript
/**
|
|
* 方洞挑战运行态共享契约。
|
|
* 后端负责当前形状、洞口兼容、胜负和连击真相；前端只提交洞口选择并渲染快照。
|
|
*/
|
|
export type SquareHoleRunStatus =
|
|
| 'running'
|
|
| 'won'
|
|
| 'failed'
|
|
| 'stopped'
|
|
| string;
|
|
export type SquareHoleShapeKind =
|
|
| 'square'
|
|
| 'circle'
|
|
| 'triangle'
|
|
| 'star'
|
|
| 'arch'
|
|
| 'diamond'
|
|
| string;
|
|
export type SquareHoleHoleKind =
|
|
| 'square'
|
|
| 'circle'
|
|
| 'triangle'
|
|
| 'star'
|
|
| 'arch'
|
|
| 'diamond'
|
|
| string;
|
|
export type SquareHoleDropRejectReason =
|
|
| 'run_not_active'
|
|
| 'snapshot_version_mismatch'
|
|
| 'hole_not_found'
|
|
| 'incompatible'
|
|
| 'time_up'
|
|
| string;
|
|
|
|
export interface SquareHoleShapeSnapshot {
|
|
shapeId: string;
|
|
shapeKind: SquareHoleShapeKind;
|
|
label: string;
|
|
targetHoleId: string;
|
|
color: string;
|
|
imageSrc?: string | null;
|
|
}
|
|
|
|
export interface SquareHoleHoleSnapshot {
|
|
holeId: string;
|
|
holeKind: SquareHoleHoleKind;
|
|
label: string;
|
|
x: number;
|
|
y: number;
|
|
imageSrc?: string | null;
|
|
}
|
|
|
|
export interface SquareHoleRunSnapshot {
|
|
runId: string;
|
|
profileId: string;
|
|
ownerUserId: string;
|
|
status: SquareHoleRunStatus;
|
|
snapshotVersion: number;
|
|
startedAtMs: number;
|
|
durationLimitMs: number;
|
|
remainingMs: number;
|
|
totalShapeCount: number;
|
|
completedShapeCount: number;
|
|
combo: number;
|
|
bestCombo: number;
|
|
score: number;
|
|
ruleLabel: string;
|
|
backgroundImageSrc?: string | null;
|
|
currentShape?: SquareHoleShapeSnapshot | null;
|
|
holes: SquareHoleHoleSnapshot[];
|
|
lastFeedback?: SquareHoleDropFeedback | null;
|
|
}
|
|
|
|
export interface StartSquareHoleRunRequest {
|
|
profileId: string;
|
|
}
|
|
|
|
export interface DropSquareHoleShapeRequest {
|
|
runId?: string;
|
|
holeId: string;
|
|
clientSnapshotVersion: number;
|
|
clientEventId: string;
|
|
droppedAtMs: number;
|
|
}
|
|
|
|
export interface StopSquareHoleRunRequest {
|
|
clientActionId: string;
|
|
}
|
|
|
|
export interface SquareHoleDropFeedback {
|
|
accepted: boolean;
|
|
rejectReason?: SquareHoleDropRejectReason | null;
|
|
message: string;
|
|
}
|
|
|
|
export interface SquareHoleDropResponse {
|
|
feedback: SquareHoleDropFeedback;
|
|
run: SquareHoleRunSnapshot;
|
|
}
|
|
|
|
export interface SquareHoleRunResponse {
|
|
run: SquareHoleRunSnapshot;
|
|
}
|