forked from MapComplete/MapComplete
		
	
		
			
				
	
	
		
			478 lines
		
	
	
	
		
			15 KiB
		
	
	
	
		
			TypeScript
		
	
	
	
	
	
			
		
		
	
	
			478 lines
		
	
	
	
		
			15 KiB
		
	
	
	
		
			TypeScript
		
	
	
	
	
	
| import * as colors from "./assets/colors.json"
 | |
| import {TileRange} from "./Models/TileRange";
 | |
| 
 | |
| export class Utils {
 | |
| 
 | |
|     /**
 | |
|      * In the 'deploy'-step, some code needs to be run by ts-node.
 | |
|      * However, ts-node crashes when it sees 'document'. When running from console, we flag this and disable all code where document is needed.
 | |
|      * This is a workaround and yet another hack
 | |
|      */
 | |
|     public static runningFromConsole = false;
 | |
|     public static readonly assets_path = "./assets/svg/";
 | |
|     public static externalDownloadFunction: (url: string) => Promise<any>;
 | |
|     private static knownKeys = ["addExtraTags", "and", "calculatedTags", "changesetmessage", "clustering", "color", "condition", "customCss", "dashArray", "defaultBackgroundId", "description", "descriptionTail", "doNotDownload", "enableAddNewPoints", "enableBackgroundLayerSelection", "enableGeolocation", "enableLayers", "enableMoreQuests", "enableSearch", "enableShareScreen", "enableUserBadge", "freeform", "hideFromOverview", "hideInAnswer", "icon", "iconOverlays", "iconSize", "id", "if", "ifnot", "isShown", "key", "language", "layers", "lockLocation", "maintainer", "mappings", "maxzoom", "maxZoom", "minNeededElements", "minzoom", "multiAnswer", "name", "or", "osmTags", "passAllFeatures", "presets", "question", "render", "roaming", "roamingRenderings", "rotation", "shortDescription", "socialImage", "source", "startLat", "startLon", "startZoom", "tagRenderings", "tags", "then", "title", "titleIcons", "type", "version", "wayHandling", "widenFactor", "width"]
 | |
|     private static extraKeys = ["nl", "en", "fr", "de", "pt", "es", "name", "phone", "email", "amenity", "leisure", "highway", "building", "yes", "no", "true", "false"]
 | |
| 
 | |
|     static EncodeXmlValue(str) {
 | |
|         if (typeof str !== "string") {
 | |
|             str = "" + str
 | |
|         }
 | |
| 
 | |
|         return str.replace(/&/g, '&')
 | |
|             .replace(/</g, '<')
 | |
|             .replace(/>/g, '>')
 | |
|             .replace(/"/g, '"')
 | |
|             .replace(/'/g, ''')
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Gives a clean float, or undefined if parsing fails
 | |
|      * @param str
 | |
|      */
 | |
|     static asFloat(str): number {
 | |
|         if (str) {
 | |
|             const i = parseFloat(str);
 | |
|             if (isNaN(i)) {
 | |
|                 return undefined;
 | |
|             }
 | |
|             return i;
 | |
|         }
 | |
|         return undefined;
 | |
|     }
 | |
| 
 | |
|     public static Upper(str: string) {
 | |
|         return str.substr(0, 1).toUpperCase() + str.substr(1);
 | |
|     }
 | |
| 
 | |
|     public static TwoDigits(i: number) {
 | |
|         if (i < 10) {
 | |
|             return "0" + i;
 | |
|         }
 | |
|         return "" + i;
 | |
|     }
 | |
| 
 | |
|     public static Round(i: number) {
 | |
|         if (i < 0) {
 | |
|             return "-" + Utils.Round(-i);
 | |
|         }
 | |
|         const j = "" + Math.floor(i * 10);
 | |
|         if (j.length == 1) {
 | |
|             return "0." + j;
 | |
|         }
 | |
|         return j.substr(0, j.length - 1) + "." + j.substr(j.length - 1, j.length);
 | |
|     }
 | |
| 
 | |
|     public static Times(f: ((i: number) => string), count: number): string {
 | |
|         let res = "";
 | |
|         for (let i = 0; i < count; i++) {
 | |
|             res += f(i);
 | |
|         }
 | |
|         return res;
 | |
|     }
 | |
| 
 | |
|     public static TimesT<T>(count: number, f: ((i: number) => T)): T[] {
 | |
|         let res: T[] = [];
 | |
|         for (let i = 0; i < count; i++) {
 | |
|             res.push(f(i));
 | |
|         }
 | |
|         return res;
 | |
|     }
 | |
| 
 | |
|     static DoEvery(millis: number, f: (() => void)) {
 | |
|         if (Utils.runningFromConsole) {
 | |
|             return;
 | |
|         }
 | |
|         window.setTimeout(
 | |
|             function () {
 | |
|                 f();
 | |
|                 Utils.DoEvery(millis, f);
 | |
|             }
 | |
|             , millis)
 | |
|     }
 | |
| 
 | |
|     public static NoNull<T>(array: T[]): T[] {
 | |
|         const ls: T[] = [];
 | |
|         for (const t of array) {
 | |
|             if (t === undefined || t === null) {
 | |
|                 continue;
 | |
|             }
 | |
|             ls.push(t);
 | |
|         }
 | |
|         return ls;
 | |
|     }
 | |
| 
 | |
|     public static NoEmpty(array: string[]): string[] {
 | |
|         const ls: string[] = [];
 | |
|         for (const t of array) {
 | |
|             if (t === "") {
 | |
|                 continue;
 | |
|             }
 | |
|             ls.push(t);
 | |
|         }
 | |
|         return ls;
 | |
|     }
 | |
| 
 | |
|     public static EllipsesAfter(str: string, l: number = 100) {
 | |
|         if (str === undefined || str === null) {
 | |
|             return undefined;
 | |
|         }
 | |
|         if (str.length <= l) {
 | |
|             return str;
 | |
|         }
 | |
|         return str.substr(0, l - 3) + "...";
 | |
|     }
 | |
| 
 | |
|     public static Dedup(arr: string[]): string[] {
 | |
|         if (arr === undefined) {
 | |
|             return undefined;
 | |
|         }
 | |
|         const newArr = [];
 | |
|         for (const string of arr) {
 | |
|             if (newArr.indexOf(string) < 0) {
 | |
|                 newArr.push(string);
 | |
|             }
 | |
|         }
 | |
|         return newArr;
 | |
|     }
 | |
|     
 | |
|     public static Identical<T>(t1: T[], t2: T[], eq?: (t: T, t0: T) => boolean): boolean{
 | |
|         if(t1.length !== t2.length){
 | |
|             return false
 | |
|         }
 | |
|         eq = (a, b) => a === b
 | |
|         for (let i = 0; i < t1.length ; i++) {
 | |
|             if(!eq(t1[i] ,t2[i])){
 | |
|                 return false
 | |
|             }
 | |
|         }
 | |
|         return true;
 | |
|     }
 | |
|     
 | |
|     public static MergeTags(a: any, b: any) {
 | |
|         const t = {};
 | |
|         for (const k in a) {
 | |
|             t[k] = a[k];
 | |
|         }
 | |
|         for (const k in b) {
 | |
|             t[k] = b[k];
 | |
|         }
 | |
|         return t;
 | |
|     }
 | |
| 
 | |
|     public static SplitFirst(a: string, sep: string): string[] {
 | |
|         const index = a.indexOf(sep);
 | |
|         if (index < 0) {
 | |
|             return [a];
 | |
|         }
 | |
|         return [a.substr(0, index), a.substr(index + sep.length)];
 | |
|     }
 | |
| 
 | |
|     public static SubstituteKeys(txt: string, tags: any) {
 | |
|         for (const key in tags) {
 | |
|             if (!tags.hasOwnProperty(key)) {
 | |
|                 continue
 | |
|             }
 | |
|             txt = txt.replace(new RegExp("{" + key + "}", "g"), tags[key])
 | |
|         }
 | |
|         return txt;
 | |
|     }
 | |
| 
 | |
|     public static LoadCustomCss(location: string) {
 | |
|         const head = document.getElementsByTagName('head')[0];
 | |
|         const link = document.createElement('link');
 | |
|         link.id = "customCss";
 | |
|         link.rel = 'stylesheet';
 | |
|         link.type = 'text/css';
 | |
|         link.href = location;
 | |
|         link.media = 'all';
 | |
|         head.appendChild(link);
 | |
|         console.log("Added custom layout ", location)
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Copies all key-value pairs of the source into the target.
 | |
|      * If the key starts with a '+', the values of the list will be appended to the target instead of overwritten
 | |
|      * @param source
 | |
|      * @param target
 | |
|      * @constructor
 | |
|      */
 | |
|     static Merge(source: any, target: any) {
 | |
|         for (const key in source) {
 | |
|             if (!source.hasOwnProperty(key)) {
 | |
|                 continue
 | |
|             }
 | |
|             if (key.startsWith("+") || key.endsWith("+")) {
 | |
|                 const trimmedKey = key.replace("+", "");
 | |
|                 const sourceV = source[key];
 | |
|                 const targetV = (target[trimmedKey] ?? [])
 | |
| 
 | |
|                 let newList: any[];
 | |
|                 if (key.startsWith("+")) {
 | |
|                     newList = sourceV.concat(targetV)
 | |
|                 } else {
 | |
|                     newList = targetV.concat(sourceV)
 | |
|                 }
 | |
| 
 | |
|                 target[trimmedKey] = newList;
 | |
|                 continue;
 | |
|             }
 | |
| 
 | |
|             const sourceV = source[key];
 | |
|             const targetV = target[key]
 | |
|             if (sourceV?.length !== undefined && targetV?.length !== undefined && key.startsWith("+")) {
 | |
|                 target[key] = targetV.concat(sourceV)
 | |
|             } else if (typeof sourceV === "object") {
 | |
|                 if (sourceV === null) {
 | |
|                     target[key] = null
 | |
|                 } else if (targetV === undefined) {
 | |
|                     target[key] = sourceV;
 | |
|                 } else {
 | |
|                     Utils.Merge(sourceV, targetV);
 | |
|                 }
 | |
| 
 | |
|             } else {
 | |
|                 target[key] = sourceV;
 | |
|             }
 | |
| 
 | |
|         }
 | |
|         return target;
 | |
|     }
 | |
| 
 | |
|     static getOrSetDefault<K, V>(dict: Map<K, V>, k: K, v: () => V) {
 | |
|         let found = dict.get(k);
 | |
|         if (found !== undefined) {
 | |
|             return found;
 | |
|         }
 | |
|         dict.set(k, v());
 | |
|         return dict.get(k);
 | |
| 
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Calculates the tile bounds of the
 | |
|      * @param z
 | |
|      * @param x
 | |
|      * @param y
 | |
|      * @returns [[maxlat, minlon], [minlat, maxlon]]
 | |
|      */
 | |
|     static tile_bounds(z: number, x: number, y: number): [[number, number], [number, number]] {
 | |
|         return [[Utils.tile2lat(y, z), Utils.tile2long(x, z)], [Utils.tile2lat(y + 1, z), Utils.tile2long(x + 1, z)]]
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Return x, y of the tile containing (lat, lon) on the given zoom level
 | |
|      */
 | |
|     static embedded_tile(lat: number, lon: number, z: number): { x: number, y: number, z: number } {
 | |
|         return {x: Utils.lon2tile(lon, z), y: Utils.lat2tile(lat, z), z: z}
 | |
|     }
 | |
| 
 | |
|     static TileRangeBetween(zoomlevel: number, lat0: number, lon0: number, lat1: number, lon1: number): TileRange {
 | |
|         const t0 = Utils.embedded_tile(lat0, lon0, zoomlevel)
 | |
|         const t1 = Utils.embedded_tile(lat1, lon1, zoomlevel)
 | |
| 
 | |
|         const xstart = Math.min(t0.x, t1.x)
 | |
|         const xend = Math.max(t0.x, t1.x)
 | |
|         const ystart = Math.min(t0.y, t1.y)
 | |
|         const yend = Math.max(t0.y, t1.y)
 | |
|         const total = (1 + xend - xstart) * (1 + yend - ystart)
 | |
| 
 | |
|         return {
 | |
|             xstart: xstart,
 | |
|             xend: xend,
 | |
|             ystart: ystart,
 | |
|             yend: yend,
 | |
|             total: total,
 | |
|             zoomlevel: zoomlevel
 | |
|         }
 | |
|     }
 | |
| 
 | |
|     public static MinifyJSON(stringified: string): string {
 | |
|         stringified = stringified.replace(/\|/g, "||");
 | |
| 
 | |
|         const keys = Utils.knownKeys.concat(Utils.extraKeys);
 | |
|         for (let i = 0; i < keys.length; i++) {
 | |
|             const knownKey = keys[i];
 | |
|             let code = i;
 | |
|             if (i >= 124) {
 | |
|                 code += 1; // Character 127 is our 'escape' character |
 | |
|             }
 | |
|             let replacement = "|" + String.fromCharCode(code)
 | |
|             stringified = stringified.replace(new RegExp(`\"${knownKey}\":`, "g"), replacement);
 | |
|         }
 | |
| 
 | |
|         return stringified;
 | |
|     }
 | |
| 
 | |
|     public static UnMinify(minified: string): string {
 | |
| 
 | |
|         if (minified === undefined || minified === null) {
 | |
|             return undefined;
 | |
|         }
 | |
| 
 | |
|         const parts = minified.split("|");
 | |
|         let result = parts.shift();
 | |
|         const keys = Utils.knownKeys.concat(Utils.extraKeys);
 | |
| 
 | |
|         for (const part of parts) {
 | |
|             if (part == "") {
 | |
|                 // Empty string => this was a || originally
 | |
|                 result += "|"
 | |
|                 continue
 | |
|             }
 | |
|             const i = part.charCodeAt(0);
 | |
|             result += "\"" + keys[i] + "\":" + part.substring(1)
 | |
|         }
 | |
| 
 | |
|         return result;
 | |
|     }
 | |
| 
 | |
|     public static MapRange<T>(tileRange: TileRange, f: (x: number, y: number) => T): T[] {
 | |
|         const result: T[] = []
 | |
|         for (let x = tileRange.xstart; x <= tileRange.xend; x++) {
 | |
|             for (let y = tileRange.ystart; y <= tileRange.yend; y++) {
 | |
|                 const t = f(x, y);
 | |
|                 result.push(t)
 | |
|             }
 | |
|         }
 | |
|         return result;
 | |
|     }
 | |
| 
 | |
|     public static downloadJson(url: string): Promise<any> {
 | |
|         if (this.externalDownloadFunction !== undefined) {
 | |
|             return this.externalDownloadFunction(url)
 | |
|         }
 | |
| 
 | |
|         return new Promise(
 | |
|             (resolve, reject) => {
 | |
|                 try {
 | |
|                     const xhr = new XMLHttpRequest();
 | |
|                     xhr.onload = () => {
 | |
|                         if (xhr.status == 200) {
 | |
|                             try {
 | |
|                                 resolve(JSON.parse(xhr.response))
 | |
|                             } catch (e) {
 | |
|                                 reject("Not a valid json: " + xhr.response)
 | |
|                             }
 | |
|                         } else {
 | |
|                             reject(xhr.statusText)
 | |
|                         }
 | |
|                     };
 | |
|                     xhr.open('GET', url);
 | |
|                     xhr.setRequestHeader("accept", "application/json")
 | |
|                     xhr.send();
 | |
|                 } catch (e) {
 | |
|                     reject(e)
 | |
|                 }
 | |
|             }
 | |
|         )
 | |
| 
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Triggers a 'download file' popup which will download the contents
 | |
|      */
 | |
|     public static offerContentsAsDownloadableFile(contents: string | Blob, fileName: string = "download.txt",
 | |
|                                                   options?: {        mimetype: string    }) {
 | |
|         const element = document.createElement("a");
 | |
|         let file;
 | |
|         if (typeof (contents) === "string") {
 | |
|             file = new Blob([contents], {type: options?.mimetype ?? 'text/plain'});
 | |
|         } else {
 | |
|             file = contents;
 | |
|         }
 | |
|         element.href = URL.createObjectURL(file);
 | |
|         element.download = fileName;
 | |
|         document.body.appendChild(element); // Required for this to work in FireFox
 | |
|         element.click();
 | |
|     }
 | |
| 
 | |
|     public static ColourNameToHex(color: string): string {
 | |
|         return colors[color.toLowerCase()] ?? color;
 | |
|     }
 | |
| 
 | |
|     public static HexToColourName(hex: string): string {
 | |
|         hex = hex.toLowerCase()
 | |
|         if (!hex.startsWith("#")) {
 | |
|             return hex;
 | |
|         }
 | |
|         const c = Utils.color(hex);
 | |
| 
 | |
|         let smallestDiff = Number.MAX_VALUE;
 | |
|         let bestColor = undefined;
 | |
|         for (const color in colors) {
 | |
|             if (!colors.hasOwnProperty(color)) {
 | |
|                 continue;
 | |
|             }
 | |
|             const foundhex = colors[color];
 | |
|             if (typeof foundhex !== "string") {
 | |
|                 continue
 | |
|             }
 | |
|             if (foundhex === hex) {
 | |
|                 return color
 | |
|             }
 | |
|             const diff = this.colorDiff(Utils.color(foundhex), c)
 | |
|             if (diff > 50) {
 | |
|                 continue;
 | |
|             }
 | |
|             if (diff < smallestDiff) {
 | |
|                 smallestDiff = diff;
 | |
|                 bestColor = color;
 | |
|             }
 | |
|         }
 | |
|         return bestColor ?? hex;
 | |
|     }
 | |
| 
 | |
| 
 | |
|     private static tile2long(x, z) {
 | |
|         return (x / Math.pow(2, z) * 360 - 180);
 | |
|     }
 | |
| 
 | |
|     private static tile2lat(y, z) {
 | |
|         const n = Math.PI - 2 * Math.PI * y / Math.pow(2, z);
 | |
|         return (180 / Math.PI * Math.atan(0.5 * (Math.exp(n) - Math.exp(-n))));
 | |
|     }
 | |
| 
 | |
|     private static lon2tile(lon, zoom) {
 | |
|         return (Math.floor((lon + 180) / 360 * Math.pow(2, zoom)));
 | |
|     }
 | |
| 
 | |
|     private static lat2tile(lat, zoom) {
 | |
|         return (Math.floor((1 - Math.log(Math.tan(lat * Math.PI / 180) + 1 / Math.cos(lat * Math.PI / 180)) / Math.PI) / 2 * Math.pow(2, zoom)));
 | |
|     }
 | |
| 
 | |
|     private static colorDiff(c0: { r: number, g: number, b: number }, c1: { r: number, g: number, b: number }) {
 | |
|         return Math.abs(c0.r - c1.r) + Math.abs(c0.g - c1.g) + Math.abs(c0.b - c1.b);
 | |
|     }
 | |
| 
 | |
|     private static color(hex: string): { r: number, g: number, b: number } {
 | |
|         if (hex.startsWith == undefined) {
 | |
|             console.trace("WUT?", hex)
 | |
|             throw "wut?"
 | |
|         }
 | |
|         if (!hex.startsWith("#")) {
 | |
|             return undefined;
 | |
|         }
 | |
|         if (hex.length === 4) {
 | |
|             return {
 | |
|                 r: parseInt(hex.substr(1, 1), 16),
 | |
|                 g: parseInt(hex.substr(2, 1), 16),
 | |
|                 b: parseInt(hex.substr(3, 1), 16),
 | |
|             }
 | |
|         }
 | |
| 
 | |
|         return {
 | |
|             r: parseInt(hex.substr(1, 2), 16),
 | |
|             g: parseInt(hex.substr(3, 2), 16),
 | |
|             b: parseInt(hex.substr(5, 2), 16),
 | |
|         }
 | |
|     }
 | |
| 
 | |
|     public static setDefaults(options, defaults) {
 | |
|         for (let key in defaults) {
 | |
|             if (!(key in options)) options[key] = defaults[key];
 | |
|         }
 | |
|         return options;
 | |
|     }
 | |
| }
 | |
| 
 |