LiveAtlas/src/index.d.ts

372 lines
8.6 KiB
TypeScript
Raw Normal View History

2021-07-25 14:12:40 +00:00
/*
* Copyright 2021 James Lyne
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
2021-05-27 13:30:56 +00:00
import {State} from "@/store";
import {DynmapUrlConfig} from "@/dynmap";
import LiveAtlasMapDefinition from "@/model/LiveAtlasMapDefinition";
import {Coords, DoneCallback, InternalTiles, PathOptions, PointTuple, PolylineOptions} from "leaflet";
2021-07-25 13:53:45 +00:00
import {CoordinatesControlOptions} from "@/leaflet/control/CoordinatesControl";
import {ClockControlOptions} from "@/leaflet/control/ClockControl";
import {LogoControlOptions} from "@/leaflet/control/LogoControl";
2021-05-15 19:25:03 +00:00
declare module "*.png" {
const value: any;
export = value;
}
declare module '*.vue' {
2021-07-19 15:40:30 +00:00
import type {DefineComponent} from 'vue'
const component: DefineComponent<{}, {}, any>
2021-05-15 19:25:03 +00:00
export default component
2020-12-20 16:01:15 +00:00
}
declare global {
// noinspection JSUnusedGlobalSymbols
interface Window {
liveAtlasConfig: LiveAtlasGlobalConfig,
}
2021-09-10 14:32:48 +00:00
declare const process : {
env: {
VITE_VERSION: string
}
}
}
export interface ProcessEnv {
[key: string]: string | undefined
}
2021-07-19 15:40:30 +00:00
interface Coordinate {
x: number;
y: number;
z: number;
}
interface LiveAtlasLocation {
x: number;
y: number;
z: number;
world?: string;
}
interface LiveAtlasGlobalConfig {
servers: Map<string, LiveAtlasServerDefinition>;
messages: LiveAtlasGlobalMessageConfig;
ui: LiveAtlasUIConfig;
}
interface LiveAtlasServerDefinition {
2021-07-25 01:02:42 +00:00
id: string;
label?: string;
2021-07-29 17:06:19 +00:00
type: 'dynmap' | 'pl3xmap';
dynmap?: DynmapUrlConfig;
pl3xmap?: string;
2021-05-20 15:13:25 +00:00
}
// Messages defined directly in LiveAtlas and used for all servers
interface LiveAtlasGlobalMessageConfig {
2021-05-20 15:13:25 +00:00
chatNoMessages: string;
2021-05-20 15:39:41 +00:00
chatTitle: string;
2021-05-20 15:13:25 +00:00
chatLogin: string;
chatSend: string;
2021-05-20 15:39:41 +00:00
chatPlaceholder: string;
2021-05-20 15:13:25 +00:00
chatErrorDisabled: string;
chatErrorUnknown: string;
2021-05-20 15:39:41 +00:00
serversHeading: string;
worldsSkeleton: string;
playersSkeleton: string;
playersTitle: string;
playersTitleHidden: string;
playersTitleOtherWorld: string;
2021-07-21 15:19:18 +00:00
playersSearchPlaceholder: string;
playersSearchSkeleton: string;
2021-05-20 15:39:41 +00:00
followingHeading: string;
followingUnfollow: string;
followingTitleUnfollow: string;
followingHidden: string;
linkTitle: string;
loadingTitle: string;
locationRegion: string;
locationChunk: string;
contextMenuCopyLink: string;
contextMenuCenterHere: string;
2021-05-25 18:26:14 +00:00
toggleTitle: string;
2021-05-26 20:13:54 +00:00
mapTitle: string;
2021-05-28 20:28:21 +00:00
layersTitle: string;
copyToClipboardSuccess: string;
copyToClipboardError: string;
2021-08-30 21:27:41 +00:00
loginTitle: string;
loginHeading: string;
loginUsernameLabel: string;
loginPasswordLabel: string;
loginSubmit: string;
loginErrorUnknown: string;
loginErrorDisabled: string;
loginErrorIncorrect: string;
loginSuccess: string;
registerHeading: string;
registerDescription: string;
registerConfirmPasswordLabel: string;
registerCodeLabel: string;
registerSubmit: string;
registerErrorUnknown: string;
registerErrorDisabled: string;
registerErrorVerifyFailed: string;
registerErrorIncorrect: string;
logoutTitle: string;
logoutErrorUnknown: string;
logoutSuccess: string;
closeTitle: string;
2021-05-25 18:26:14 +00:00
}
// Messages defined by dynmap configuration responses and can vary per server
interface LiveAtlasServerMessageConfig {
chatPlayerJoin: string;
chatPlayerQuit: string;
chatAnonymousJoin: string;
chatAnonymousQuit: string;
chatErrorNotAllowed: string;
chatErrorRequiresLogin: string;
chatErrorCooldown: string;
worldsHeading: string;
playersHeading: string;
}
type LiveAtlasMessageConfig = LiveAtlasGlobalMessageConfig & LiveAtlasServerMessageConfig;
interface LiveAtlasUIConfig {
playersAboveMarkers: boolean;
2021-07-21 15:19:18 +00:00
playersSearch: boolean;
}
2021-08-30 21:27:41 +00:00
export type LiveAtlasUIElement = 'layers' | 'chat' | 'players' | 'maps';
export type LiveAtlasUIModal = 'login' | 'settings';
export type LiveAtlasSidebarSection = 'servers' | 'players' | 'maps';
2021-07-21 16:27:24 +00:00
export type LiveAtlasDimension = 'overworld' | 'nether' | 'end';
interface LiveAtlasPlayer {
name: string;
displayName: string;
uuid?: string;
armor: number;
health: number;
sort: number;
hidden: boolean;
location: LiveAtlasLocation;
}
interface LiveAtlasSortedPlayers extends Array<LiveAtlasPlayer> {
dirty?: boolean;
}
2021-07-19 15:40:30 +00:00
interface LiveAtlasWorldDefinition {
2021-07-19 15:40:30 +00:00
seaLevel: number;
name: string;
2021-07-24 19:12:18 +00:00
displayName: string;
2021-07-21 16:27:24 +00:00
dimension: LiveAtlasDimension;
2021-07-19 15:40:30 +00:00
protected: boolean;
height: number;
center: Coordinate;
maps: Map<string, LiveAtlasMapDefinition>;
2021-07-19 15:40:30 +00:00
}
interface LiveAtlasWorldState {
raining: boolean;
thundering: boolean;
timeOfDay: number;
}
interface LiveAtlasParsedUrl {
world?: string;
map?: string;
location?: Coordinate;
zoom?: number;
legacy: boolean;
}
interface LiveAtlasMapProvider {
loadServerConfiguration(): Promise<void>;
populateWorld(world: LiveAtlasWorldDefinition): Promise<void>;
startUpdates(): void;
stopUpdates(): void;
sendChatMessage(message: string): void;
2021-08-30 21:27:41 +00:00
login(formData: FormData): void;
logout(): void;
register(formData: FormData): void;
destroy(): void;
getPlayerHeadUrl(entry: HeadQueueEntry): string;
getTilesUrl(): string;
getMarkerIconUrl(icon: string): string;
}
2021-07-24 03:06:19 +00:00
interface LiveAtlasMarkerSet {
id: string,
label: string;
hidden: boolean;
priority: number;
minZoom?: number;
maxZoom?: number;
showLabels?: boolean;
markers: Map<string, LiveAtlasMarker>;
areas: Map<string, LiveAtlasArea>;
lines: Map<string, LiveAtlasLine>;
circles: Map<string, LiveAtlasCircle>;
}
interface LiveAtlasMarker {
dimensions: PointTuple;
icon: string;
label: string;
isLabelHTML: boolean;
2021-07-24 03:06:19 +00:00
location: Coordinate;
minZoom?: number;
maxZoom?: number;
popupContent?: string;
}
interface LiveAtlasPath {
style: PathOptions;
2021-07-24 03:06:19 +00:00
minZoom?: number;
maxZoom?: number;
popupContent?: string;
2021-07-29 02:06:05 +00:00
tooltipContent?: string;
isPopupHTML: boolean;
2021-07-24 03:06:19 +00:00
}
interface LiveAtlasArea extends LiveAtlasPath {
2021-07-24 03:06:19 +00:00
style: PolylineOptions;
outline: boolean;
points: Coordinate[] | Coordinate[][] | Coordinate[][][]
2021-07-24 03:06:19 +00:00
}
interface LiveAtlasLine extends LiveAtlasPath {
points: Coordinate[];
style: PolylineOptions;
}
interface LiveAtlasCircle extends LiveAtlasPath {
2021-07-24 03:06:19 +00:00
location: Coordinate;
radius: PointTuple;
style: PathOptions;
}
interface HeadQueueEntry {
cacheKey: string;
name: string;
uuid?: string;
size: string;
image: HTMLImageElement;
}
2021-07-25 13:53:45 +00:00
interface LiveAtlasServerConfig {
defaultMap?: string;
defaultWorld?: string;
defaultZoom: number;
followMap?: string;
2021-07-28 22:52:51 +00:00
followZoom?: number;
2021-07-25 13:53:45 +00:00
title: string;
expandUI: boolean;
}
interface LiveAtlasComponentConfig {
markers: {
showLabels: boolean;
};
playerMarkers?: LiveAtlasPlayerMarkerConfig;
coordinatesControl?: CoordinatesControlOptions;
clockControl?: ClockControlOptions;
linkControl: boolean;
layerControl: boolean;
logoControls: Array<LogoControlOptions>;
chatBox?: LiveAtlasChatBoxConfig;
chatSending?: LiveAtlasChatSendingConfig;
chatBalloons: boolean;
login: boolean;
}
interface LiveAtlasPartialComponentConfig {
markers?: {
showLabels: boolean;
};
playerMarkers?: LiveAtlasPlayerMarkerConfig;
coordinatesControl?: CoordinatesControlOptions;
clockControl?: ClockControlOptions;
linkControl?: boolean;
layerControl?: boolean;
logoControls?: Array<LogoControlOptions>;
chatBox?: LiveAtlasChatBoxConfig;
chatSending?: LiveAtlasChatSendingConfig;
chatBalloons?: boolean;
login?: boolean;
}
2021-07-25 13:53:45 +00:00
interface LiveAtlasPlayerMarkerConfig {
grayHiddenPlayers: boolean;
2021-07-25 13:53:45 +00:00
hideByDefault: boolean;
layerName: string;
layerPriority: number;
showBodies: boolean;
showSkinFaces: boolean;
showHealth: boolean;
smallFaces: boolean;
}
interface LiveAtlasChatBoxConfig {
allowUrlName: boolean;
showPlayerFaces: boolean;
messageLifetime: number;
messageHistory: number;
}
interface LiveAtlasChatSendingConfig {
loginRequired: boolean;
maxLength: number;
cooldown: number;
}
interface LiveAtlasChat {
type: 'chat' | 'playerjoin' | 'playerleave';
playerAccount?: string;
playerName?: string;
channel?: string;
message?: string;
source?: string;
timestamp: number;
}
export interface LiveAtlasInternalTiles extends InternalTiles {
[key: string]: LiveAtlasTile;
}
export interface LiveAtlasTile {
active?: boolean;
coords: Coords;
current: boolean;
el: LiveAtlasTileElement;
loaded?: Date;
retain?: boolean;
complete: boolean;
}
export interface LiveAtlasTileElement extends HTMLImageElement {
tileName?: string;
url: string;
callback: DoneCallback;
abortController: AbortController;
}