x4js 1.6.4 → 2.0.1

package/lib/src/tools.ts

@@ -1,1473 +0,0 @@
-/**
-*  ___   ___ __
-*  \  \_/  /  / _
-*   \     /  /_| |_
-*   /  _  \____   _|  
-*  /__/ \__\   |_|
-*        
-* @file tools.ts
-* @author Etienne Cochard 
-*
-* Copyright (c) 2019-2023 R-libre ingenierie
-*
-* Permission is hereby granted, free of charge, to any person obtaining a copy 
-* of this software and associated documentation files (the "Software"), to deal 
-* in the Software without restriction, including without limitation the rights 
-* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies 
-* of the Software, and to permit persons to whom the Software is furnished to do so, 
-* subject to the following conditions:
-* The above copyright notice and this permission notice shall be included in all copies
-* or substantial portions of the Software.
-*
-* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, 
-* INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A 
-* PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT 
-* HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 
-* OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-**/
-
-import { x4document } from './x4dom'
-
-import { _tr } from './i18n'; 	// you MUST create a file named translation.js
-
-// :: ENVIRONMENT ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
-
-/**
- * @return true is the device has touch
- */
-
-export function isTouchDevice() {
-	return 'ontouchstart' in window;
-}
-
-// :: NUMBERS ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
-
-
-/**
- * round to a given number of decimals
- * @param num numbre to round
- * @param ndec number of decimals
- * @returns number rounded
- */
-
-export function roundTo(num: number, ndec: number) {
-	let mul = Math.pow(10, ndec);
-	let res = Math.round(num * mul) / mul;
-	if (Object.is(res, -0)) {	// res===-0.0 
-		res = 0;
-	}
-	return res;
-}
-
-/**
- * parse an intl formatted number
- * understand grouping and ',' separator
- * @review us format: grouping = ','
- * @param num 
- */
-
-export function parseIntlFloat(num: string) {
-	num = num.replace(/\s*/g, '');	// group separator
-	num = num.replace(',', '.');		// decimal separator
-
-	// accept empty & return 0.0
-	if (num.length == 0) {
-		return 0.0;
-	}
-
-	return parseFloat(num);
-}
-
-// :: STRING MANIP ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
-
-const RE_PCASE = /([a-z][A-Z])/g;
-const RE_PCASE2 = /[^-a-z0-9]+/g;
-
-/**
- * inverse of camel case
- * theThingToCase -> the-thing-to-case
- * @param {String} str 
- */
-
-export function pascalCase(string: string): string {
-
-	let result = string;
-
-	result = result.replace(/([a-z])([A-Z])/g, "$1 $2");
-	result = result.toLowerCase();
-	result = result.replace(/[^- a-z0-9]+/g, ' ');
-
-	if (result.indexOf(' ') < 0) {
-		return result;
-	}
-
-	result = result.trim();
-	return result.replace(/ /g, '-');
-}
-
-export function camelCase( text: string ) {
-	let result = text.toLowerCase( );
-	result = result.replace( /[^a-zA-Z0-9]+(.)/g, (m,chr) => {
-		return chr.toUpperCase();
-	} );
-	return result;
-}
-
-// :: MISC CLASSES ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
-
-export type Constructor<T> = new (...args: any[]) => T;
-
-export class Point {
-	x: number;
-	y: number;
-
-	constructor(x = 0, y = 0) {
-		this.x = x;
-		this.y = y;
-	}
-}
-
-export class Size {
-	width: number;
-	height: number;
-
-	constructor(w = 0, h = 0) {
-		this.width = w;
-		this.height = h;
-	}
-}
-
-export class Rect {
-
-	left: number;
-	top: number;
-	width: number;
-	height: number;
-
-	constructor();
-	constructor(rc: Rect);
-	constructor(rc: DOMRect);
-	constructor(left: number, top: number, width: number, height: number);
-	constructor(left?: number | Rect | DOMRect, top?: number, width?: number, height?: number) {
-
-		if (left === undefined) {
-			this.left = this.top = this.right = this.bottom = 0;
-		}
-		else if (left instanceof Rect || left instanceof DOMRect) {
-			let rc = left;
-			this.left = rc.left;
-			this.top = rc.top;
-			this.width = rc.width;
-			this.height = rc.height;
-		}
-		else {
-			this.left = left;
-			this.top = top;
-			this.width = width;
-			this.height = height;
-		}
-	}
-
-	set(left: number, top: number, width: number, height: number) {
-		this.left = left;
-		this.top = top;
-		this.width = width;
-		this.height = height;
-	}
-
-	get bottom(): number {
-		return this.top + this.height;
-	}
-
-	set bottom(bottom: number) {
-		this.height = bottom - this.top;
-	}
-
-	get right(): number {
-		return this.left + this.width;
-	}
-
-	set right(right: number) {
-		this.width = right - this.left;
-	}
-
-	get topLeft(): Point {
-		return new Point(this.left, this.top);
-	}
-
-	get bottomRight(): Point {
-		return new Point(this.right, this.bottom);
-	}
-
-	get size(): Size {
-		return new Size(this.width, this.height);
-	}
-
-	moveTo(left: number, top: number): this {
-		this.left = left;
-		this.top = top;
-		return this;
-	}
-
-	movedTo(left: number, top: number): Rect {
-		return new Rect(left, top, this.width, this.height);
-	}
-
-	moveBy(dx: number, dy: number): this {
-		this.left += dx;
-		this.top += dy;
-		return this;
-	}
-
-	movedBy(dx: number, dy: number): Rect {
-		return new Rect(this.left + dx, this.top + dy, this.width, this.height);
-	}
-
-	isEmpty() {
-		return this.width == 0 && this.height == 0;
-	}
-
-	normalize(): this {
-		let w = this.width,
-			h = this.height;
-
-		if (w < 0) {
-			this.left += w;
-			this.width = -w;
-		}
-
-		if (h < 0) {
-			this.top += h;
-			this.height = -h;
-		}
-
-		return this;
-	}
-
-	normalized(): Rect {
-
-		let rc = new Rect(this);
-		let w = rc.width,
-			h = rc.height;
-
-
-		if (w < 0) {
-			rc.left += w;
-			rc.width = -w;
-		}
-
-		if (h < 0) {
-			rc.top += h;
-			rc.height = -h;
-		}
-
-		return rc;
-	}
-
-	/**
-	 * @deprecated
-	 */
-	containsPt(x: number, y: number): boolean {
-		return x >= this.left && x <= this.right && y >= this.top && y <= this.bottom;
-	}
-
-	contains(pt: Point): boolean;
-	contains(rc: Rect): boolean;
-	contains(arg: any): boolean {
-		if (arg instanceof Rect) {
-			return arg.left >= this.left && arg.right <= this.right && arg.top >= this.top && arg.bottom <= this.bottom;
-		}
-		else {
-			return arg.x >= this.left && arg.x < this.right && arg.y >= this.top && arg.y < this.bottom;
-		}
-	}
-
-	touches(rc: Rect): boolean {
-		if (this.left > rc.right || this.right < rc.left || this.top > rc.bottom || this.bottom < rc.top) {
-			return false;
-		}
-
-		return true;
-	}
-
-	inflate(dx: number, dy?: number) {
-		if (dy === undefined) {
-			dy = dx;
-		}
-
-		this.left -= dx;
-		this.top -= dy;
-		this.width += dx + dx;
-		this.height += dy + dy;
-	}
-
-	inflatedBy(dx: number, dy?: number) {
-		if (dy === undefined) {
-			dy = dx;
-		}
-		return new Rect(this.left - dx, this.top - dy, this.width + dx + dx, this.height + dy + dy);
-	}
-
-	combine(rc: Rect) {
-		let left = Math.min(this.left, rc.left);
-		let top = Math.min(this.top, rc.top);
-		let right = Math.max(this.right, rc.right);
-		let bottom = Math.max(this.bottom, rc.bottom);
-
-		this.left = left;
-		this.top = top;
-		this.right = right;
-		this.bottom = bottom;
-	}
-}
-
-/**
- * replace {0..9} by given arguments
- * @param format string
- * @param args 
- * 
- * @example ```ts
- * 
- * console.log( sprintf( 'here is arg 1 {1} and arg 0 {0}', 'argument 0', 'argument 1' ) )
- */
-
-export function sprintf(format: string, ...args) {
-	return format.replace(/{(\d+)}/g, function (match, index) {
-		return typeof args[index] != 'undefined' ? args[index] : match;
-	});
-}
-
-/**
- * replace special characters for display
- * @param unsafe 
- * 
- * console.log( escapeHtml('<div style="width:50px; height: 50px; background-color:red"></div>') );
- */
-export function escapeHtml(unsafe: string, nl_br = false): string {
-	if (!unsafe || unsafe.length == 0) {
-		return "";
-	}
-
-	let result = unsafe.replace(/[<>\&\"\']/g, function (c) {
-		return '&#' + c.charCodeAt(0) + ';';
-	});
-
-	if (nl_br) {
-		result = result.replace(/(\r\n|\n\r|\r|\n)/g, '<br/>');
-	}
-
-	return result;
-}
-
-/**
- * replace special characters for display
- * @author Steven Levithan <http://slevithan.com/>
- * @param unsafe 
- * 
- * console.log( removeHtmlTags('<h1>sss</h1>') );
- */
-
-export function removeHtmlTags(unsafe: string, nl_br = false): string {
-	
-	if ( unsafe===undefined || unsafe===null || !isString(unsafe) || unsafe.length == 0 ) {
-		return "";
-	} 
-
-	let ret_val = '';
-	for (let i = 0; i < unsafe.length; i++) {
-		const ch = unsafe.codePointAt(i);
-		if (ch > 127) {
-			ret_val += '&#' + ch + ';';
-		}
-		else if (ch == 60/*<*/) {
-			ret_val += '&lt;'
-		}
-		else {
-			ret_val += unsafe.charAt(i);
-		}
-	}
-	return ret_val;
-}
-
-
-// :: DATES ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
-
-let cur_locale: string = 'fr-FR';
-
-/**
- * change the current locale for misc translations (date...)
- * @param locale 
- */
-
-export function _date_set_locale(locale: string) {
-	cur_locale = locale;
-}
-
-/**
- * 
- * @param date 
- * @param options 
- * @example
- * let date = new Date( );
- * let options = { day: 'numeric', month: 'numeric', year: 'numeric', hour: 'numeric', minute: 'numeric' };
- * let text = date_format( date, options );
- */
-
-export function date_format(date: Date, options?: any): string {
-	//return new Intl.DateTimeFormat(cur_locale, options).format( date );
-	return formatIntlDate(date);
-}
-
-/**
- * 
- * @param date 
- * @param options 
- */
-
-export function date_diff(date1: Date, date2: Date, options?: any): string {
-
-	var dt = (date1.getTime() - date2.getTime()) / 1000;
-
-	// seconds
-	let sec = dt;
-	if (sec < 60) {
-		return sprintf(_tr.global.diff_date_seconds, Math.round(sec));
-	}
-
-	// minutes
-	let min = Math.floor(sec / 60);
-	if (min < 60) {
-		return sprintf(_tr.global.diff_date_minutes, Math.round(min));
-	}
-
-	// hours
-	let hrs = Math.floor(min / 60);
-	return sprintf(_tr.global.diff_date_hours, hrs, min % 60);
-}
-
-export function date_to_sql(date: Date, withHours: boolean) {
-
-	if (withHours) {
-		return formatIntlDate(date, 'Y-M-D H:I:S');
-	}
-	else {
-		return formatIntlDate(date, 'Y-M-D');
-	}
-}
-
-/**
- * construct a date from an utc date time (sql format)
- * YYYY-MM-DD HH:MM:SS
- */
-
-export function date_sql_utc(date: string): Date {
-	let result = new Date(date + ' GMT');
-	return result;
-}
-
-
-
-/**
- * return a number that is a representation of the date
- * this number can be compared with another hash
- */
-
-export function date_hash(date: Date): number {
-	return date.getFullYear() << 16 | date.getMonth() << 8 | date.getDate();
-}
-
-(<any>Date.prototype).hash = function (this: Date) {
-	return date_hash(this);
-}
-
-/**
- * return a copy of a date
- */
-
-export function date_clone(date: Date): Date {
-	return new Date(date.getTime());
-}
-
-/**
- * return the week number of a date
- */
-
-export function date_calc_weeknum(date: Date): number {
-	const firstDayOfYear = new Date(date.getFullYear(), 0, 1);
-	const pastDaysOfYear = (date.valueOf() - firstDayOfYear.valueOf()) / 86400000;
-	return Math.floor((pastDaysOfYear + firstDayOfYear.getDay() + 1) / 7);
-}
-
-
-
-/**
- * parse a date according to the given format 
- * @param value - string date to parse
- * @param fmts - format list - i18 tranlation by default
- * allowed format specifiers:
- * d or D: date (1 or 2 digits)
- * m or M: month (1 or 2 digits)
- * y or Y: year (2 or 4 digits)
- * h or H: hours (1 or 2 digits)
- * i or I: minutes (1 or 2 digits)
- * s or S: seconds (1 or 2 digits)
- * <space>: 1 or more spaces
- * any other char: <0 or more spaces><the char><0 or more spaces>
- * each specifiers is separated from other by a pipe (|)
- * more specific at first
- * @example
- * 'd/m/y|d m Y|dmy|y-m-d h:i:s|y-m-d'
- */
-
-export function parseIntlDate(value: string, fmts: string = _tr.global.date_input_formats): Date {
-
-	let formats = fmts.split('|');
-	for (let fmatch of formats) {
-
-		//review: could do that only once & keep result
-		//review: add hours, minutes, seconds
-
-		let smatch = '';
-		for (let c of fmatch) {
-
-			if (c == 'd' || c == 'D') {
-				smatch += '(?<day>\\d{1,2})';
-			}
-			else if (c == 'm' || c == 'M') {
-				smatch += '(?<month>\\d{1,2})';
-			}
-			else if (c == 'y' || c == 'Y') {
-				smatch += '(?<year>\\d{1,4})';
-			}
-			else if (c == 'h' || c == 'H') {
-				smatch += '(?<hour>\\d{1,2})';
-			}
-			else if (c == 'i' || c == 'I') {
-				smatch += '(?<min>\\d{1,2})';
-			}
-			else if (c == 's' || c == 'S') {
-				smatch += '(?<sec>\\d{1,2})';
-			}
-			else if (c == ' ') {
-				smatch += '\\s+';
-			}
-			else {
-				smatch += '\\s*\\' + c + '\\s*';
-			}
-		}
-
-		let rematch = new RegExp('^' + smatch + '$', 'm');
-
-		let match = rematch.exec(value);
-
-		if (match) {
-			const now = new Date( );
-
-			let d = parseInt(match.groups.day ?? '1');
-			let m = parseInt(match.groups.month ?? '1');
-			let y = parseInt(match.groups.year ?? now.getFullYear()+'');
-			let h = parseInt(match.groups.hour ?? '0');
-			let i = parseInt(match.groups.min ?? '0');
-			let s = parseInt(match.groups.sec ?? '0');
-
-			if (y > 0 && y < 100) {
-				y += 2000;
-			}
-
-			let result = new Date(y, m - 1, d, h, i, s, 0);
-
-			// we test the vdate validity (without adjustments)
-			// without this test, date ( 0, 0, 0) is accepted and transformed to 1969/11/31 (not fun)
-			let ty = result.getFullYear(),
-				tm = result.getMonth() + 1,
-				td = result.getDate();
-
-			if (ty != y || tm != m || td != d) {
-				//debugger;
-				return null;
-			}
-
-			return result;
-		}
-	}
-
-	return null;
-}
-
-/**
- * format a date as string 
- * @param date - date to format
- * @param fmt - format 
- * format specifiers:
- * d: date 
- * D: 2 digits date padded with 0
- * j: day of week short mode 'mon'
- * J: day of week long mode 'monday'
- * w: week number
- * m: month
- * M: 2 digits month padded with 0
- * o: month short mode 'jan'
- * O: month long mode 'january'
- * y or Y: year
- * h: hour (24 format)
- * H: 2 digits hour (24 format) padded with 0
- * i: minutes
- * I: 2 digits minutes padded with 0
- * s: seconds
- * S: 2 digits seconds padded with 0
- * a: am or pm
- * anything else is inserted
- * if you need to insert some text, put it between {}
- * 
- * @example
- * 
- * 01/01/1970 11:25:00 with '{this is my demo date formatter: }H-i*M'
- * "this is my demo date formatter: 11-25*january"
- */
-
-export function formatIntlDate(date: Date, fmt: string = _tr.global.date_format) {
-
-	if (!date) {
-		return '';
-	}
-
-	let now = {
-		year: date.getFullYear(),
-		month: date.getMonth() + 1,
-		day: date.getDate(),
-		wday: date.getDay(),
-		hours: date.getHours(),
-		minutes: date.getMinutes(),
-		seconds: date.getSeconds(),
-		milli: date.getMilliseconds()
-	};
-
-
-	let result = '';
-	let esc = 0;
-
-	for (let c of fmt) {
-
-		if (c == '{') {
-			if (++esc == 1) {
-				continue;
-			}
-		}
-		else if (c == '}') {
-			if (--esc == 0) {
-				continue;
-			}
-		}
-
-		if (esc) {
-			result += c;
-			continue;
-		}
-
-		if (c == 'd') {
-			result += now.day;
-		}
-		else if (c == 'D') {
-			result += pad(now.day, -2);
-		}
-		else if (c == 'j') { // day short
-			result += _tr.global.day_short[now.wday];
-		}
-		else if (c == 'J') { // day long
-			result += _tr.global.day_long[now.wday];
-		}
-		else if (c == 'w') {	// week
-			result += date_calc_weeknum(date);
-		}
-		else if (c == 'W') {	// week
-			result += pad(date_calc_weeknum(date), -2);
-		}
-		else if (c == 'm') {
-			result += now.month;
-		}
-		else if (c == 'M') {
-			result += pad(now.month, -2);
-		}
-		else if (c == 'o') {	// month short
-			result += _tr.global.month_short[now.month - 1];
-		}
-		else if (c == 'O') {	// month long
-			result += _tr.global.month_long[now.month - 1];
-		}
-		else if (c == 'y' || c == 'Y') {
-			result += pad(now.year, -4);
-		}
-		else if (c == 'a' || c == 'A') {
-			result += now.hours < 12 ? 'am' : 'pm';
-		}
-		else if (c == 'h') {
-			result += now.hours;
-		}
-		else if (c == 'H') {
-			result += pad(now.hours, -2);
-		}
-		else if (c == 'i') {
-			result += now.minutes;
-		}
-		else if (c == 'I') {
-			result += pad(now.minutes, -2);
-		}
-		else if (c == 's') {
-			result += now.seconds;
-		}
-		else if (c == 'S') {
-			result += pad(now.seconds, -2);
-		}
-		else if (c == 'l') {
-			result += now.milli;
-		}
-		else if (c == 'L') {
-			result += pad(now.milli, -3);
-		}
-		else {
-			result += c;
-		}
-	}
-
-	return result;
-}
-
-export function calcAge(birth: Date, ref?: Date) {
-	if (ref === undefined) {
-		ref = new Date();
-	}
-
-	if (!birth) {
-		return 0;
-	}
-
-	let age = ref.getFullYear() - birth.getFullYear();
-	if (ref.getMonth() < birth.getMonth() || (ref.getMonth() == birth.getMonth() && ref.getDate() < birth.getDate())) {
-		age--;
-	}
-
-	return age;
-}
-
-
-/**
- * date object patch
- */
-
-declare global {
-	interface Date {
-		hash(): number;
-		clone(): Date;
-		weekNum(): number;
-		format(format: string): string;
-		isSameDay(date: Date): boolean;
-		addDays( days: number );
-	}
-}
-
-Date.prototype.isSameDay = function (date: Date) {
-	return this.getDate() == date.getDate() && this.getMonth() == date.getMonth() && this.getFullYear() == date.getFullYear();
-}
-
-Date.prototype.hash = function () {
-	return date_hash(this);
-}
-
-Date.prototype.clone = function () {
-	return date_clone(this);
-}
-
-Date.prototype.weekNum = function () {
-	return date_calc_weeknum(this);
-}
-
-Date.prototype.format = function (fmt: string) {
-	return formatIntlDate(this, fmt);
-}
-
-Date.prototype.addDays = function ( days: number ): Date {
-	this.setDate( this.getDate() + days );
-	return this;
-}
-
-
-
-// :: FILE CREATION ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
-
-
-/**
- * 
- * @param data data to export
- * @param mimetype - 'text/plain'
- */
-
-export function downloadData(data, mimetype: string, filename: string) {
-
-	//if (data !== null && navigator.msSaveBlob) {
-	//	return navigator.msSaveBlob(new Blob([data], { type: mimetype }), filename);
-	//}
-
-	let blob = new Blob([data], { type: mimetype });
-	let url = window.URL.createObjectURL(blob);
-
-	let a = x4document.createElement("a");
-	a.style['display'] = "none";
-	a.href = url;
-	a.download = filename;
-	x4document.body.appendChild(a);
-
-	a.click();
-	window.URL.revokeObjectURL(url);
-}
-
-// :: MISC ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
-
-
-/**
- * check if a value is a string
- * @param val 
- */
-export function isString(val: any): val is string {
-	return typeof val === 'string';
-}
-
-/**
- * check is a value is an array
- * @param val 
- */
-export function isArray(val: any): val is any[] {
-	return val instanceof Array;
-}
-
-/**
- * 
- */
-
-export function isFunction(val: any): val is Function {
-	return val instanceof Function;
-}
-
-/**
- * 
- */
-
-export function isLiteralObject(val: any) {
-	return (!!val) && (val.constructor === Object);
-};
-
-/**
- * prepend 0 to a value to a given length
- * @param value 
- * @param length 
- */
-
-export function pad(what: unknown, size: number, ch: string = '0') {
-
-	let value: string;
-
-	if (!isString(what)) {
-		value = '' + what;
-	}
-	else {
-		value = what;
-	}
-
-	if (size > 0) {
-		return value.padEnd(size, ch);
-	}
-	else {
-		return value.padStart(-size, ch);
-	}
-}
-
-
-/**
- * return true if val is a finite number
- */
-
-export function isNumber(val: any): val is number {
-	return typeof val === 'number' && isFinite(val);
-}
-
-/**
- * 
- * @param name 
- */
-
-export function waitFontLoading(name: string) {
-
-	// tip for waiting font loading:
-	// by default, body is created invisible ((opacity = 0)
-	// we create a div inside with the font we need to wait the loading
-	// as soon as the font is loaded, it's size will change, the browser end font loading
-	// we can remove the div.
-	// pitfall: if the font is already loaded, ne never end.
-	// @review that
-
-	let ct = x4document.createElement('div');
-
-	ct.style.position = 'absolute';
-	ct.style.fontFamily = name;
-	ct.style.fontSize = '44px';
-	ct.style.opacity = '0.001';
-	ct.innerText = 'X';
-
-	x4document.body.appendChild(ct);
-
-	return new Promise<void>((resolve) => {
-
-		let irc = ct.getBoundingClientRect();
-		let tm = setInterval(() => {
-
-			let nrc = ct.getBoundingClientRect();
-			if (nrc.height != irc.height) {
-				clearInterval(tm);
-				x4document.body.removeChild(ct);
-
-				resolve();
-			}
-		}, 0);
-	});
-}
-
-/**
- * 
- * @param fn 
- * @param tm 
- * 
- * @example:
- * 
- * defer( ( ) => {
- * 	console.log( x );
- * } )(  );
- */
-
-export function deferCall(fn: Function, tm = 0, ...args) {
-	setTimeout(fn, tm, ...args);
-}
-
-/**
- * 
- */
-
-export function asap(cb: (time: number) => void) {
-	requestAnimationFrame(cb);
-}
-
-
-
-/**
- * micro md to html
- * 
- * understand:
- * 	**bold**
- * 	*italic*
- * 
- *  > quote
- *  - list
- *  # title lvl 1
- *  ## title lvl 2
- *  ### title lvl 3 ...
- * 
- */
-
-export function markdownToHtml(text: string): string {
-
-	if (!text) {
-		return '';
-	}
-
-	let lines = text.split('\n');
-
-	let state = 'para';
-	let div = 'p';
-	let result: string[] = [];
-
-	lines.forEach((l) => {
-
-		let txt = l.trim();
-
-		if (state == 'para') {
-			// entree en mode list
-			if (txt[0] == '-') {
-				txt = txt.substr(1);
-				result.push('<ul>')
-				state = 'list';
-				div = 'li';
-			}
-			else if (txt[0] == '>') {
-				txt = txt.substr(1);
-				result.push('<blockquote>')
-				state = 'quote';
-				div = 'p';
-			}
-			else if (txt[0] == '#') {
-				let lvl = 0;
-				do {
-					txt = txt.substr(1);
-					lvl++;
-				} while (txt[0] == '#' && lvl < 5);
-
-				div = 'h' + lvl;
-				state = 'title';
-			}
-		}
-		else if (state == 'list') {
-			// sortie du mode list
-			if (txt[0] != '-') {
-				result.push('</ul>')
-				state = 'para';
-				div = 'p';
-			}
-			else {
-				txt = txt.substr(1);
-			}
-		}
-		else if (state == 'quote') {
-
-			// sortie du mode blockquote
-			if (txt[0] != '>') {
-				result.push('</blockquote>')
-				state = 'para';
-				div = 'p';
-			}
-			else {
-				txt = txt.substr(1);
-			}
-		}
-
-		let reBold = /\*\*([^*]+)\*\*/gi;
-
-		txt = escapeHtml(txt, false);
-		txt = txt.replace(reBold, (sub: string, ...a): string => {
-			return '<b>' + sub.substr(2, sub.length - 4) + '</b>';
-		});
-
-		let reItalic = /\*([^*]+)\*/gi;
-		txt = txt.replace(reItalic, (sub: string, ...a): string => {
-			return '<i>' + sub.substr(1, sub.length - 2) + '</i>';
-		});
-
-		// keep empty lines
-		if (txt == '') {
-			txt = '&nbsp;';
-		}
-
-		result.push(`<${div}>` + txt + `</${div}>`);
-
-		if (state == 'title') {
-			state = 'para';
-			div = 'p';
-		}
-	});
-
-	if (state == 'list') {
-		result.push('</ul>')
-	}
-	else if (state == 'quote') {
-		result.push('</blockquote>')
-	}
-
-	return result.join('');
-}
-
-
-/**
- * 
- */
-
-export class NetworkError extends Error {
-
-	private m_code: number;
-
-	constructor(response: Response);
-	constructor(code: number, text: string);
-	constructor(a: number | Response, b?: string) {
-
-		if (a instanceof Response) {
-			super(a.statusText);
-			this.m_code = a.status;
-		}
-		else {
-			super(b);
-			this.m_code = a;
-		}
-	}
-
-	get code(): number {
-		return this.m_code;
-	}
-}
-
-/**
- * return the mouse pos in client coordinates
- * handle correctly touch & mouse
- */
-
-export function getMousePos(ev: UIEvent, fromDoc: boolean): Point {
-
-	let x_name = 'offsetX',
-		y_name = 'offsetY';
-
-	if (fromDoc) {
-		x_name = 'clientX';
-		y_name = 'clientY';
-	}
-
-	if (ev.type == 'mousemove' || ev.type == 'mousedown' || ev.type == 'mouseup') {
-		let em = ev as MouseEvent;
-		return new Point(em[x_name], em[y_name]);
-	}
-	else if (ev.type == 'pointermove' || ev.type == 'pointerdown' || ev.type == 'pointerup') {
-		let em = ev as MouseEvent;
-		return new Point(em[x_name], em[y_name]);
-	}
-	else if (ev.type == 'touchmove' || ev.type == 'touchstart') {
-		let et = ev as TouchEvent;
-		return new Point(et.touches[0][x_name], et.touches[0][y_name]);
-	}
-	else if (ev.type == 'contextmenu') {
-		let em = ev as MouseEvent;
-		return new Point(em[x_name], em[y_name]);
-	}
-	else {
-		return new Point(0, 0);
-	}
-}
-
-/**
- * clamp a value
- * @param v - value to clamp
- * @param min - min value
- * @param max - max value
- * @returns clamped value
- */
-
-export function clamp(v: number, min: number, max: number) {
-	return Math.min(Math.max(v, min), max);
-}
-
-
-/**
- * 
- */
-
-export interface IDisposable {
-	dispose();
-}
-
-// :: HTML strings ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
-
-export class HtmlString extends String {
-	constructor(text: string) { super(text); }
-
-	static from(text: string) {
-		return new HtmlString(text);
-	}
-}
-
-export function html(a, ...b): HtmlString {
-	return HtmlString.from(String.raw(a, ...b));
-}
-
-export function isHtmlString(val: any): val is HtmlString {
-	return val instanceof HtmlString;
-}
-
-// :: CLIPBOARD ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
-
-export class Clipboard {
-	static copy(data: any) {
-		if (navigator.clipboard) {
-			navigator.clipboard.writeText(JSON.stringify(data));
-		}
-	}
-
-	static paste(cb: (data: string) => void) {
-		if (navigator.clipboard) {
-			navigator.clipboard.readText().then(v => cb(v));
-		}
-		else {
-			console.error('no clipboard, are you in https ?');
-		}
-	}
-}
-
-
-// :: CRC32 ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
-
-/**
- * Calculates the CRC32 checksum of a string.
- * taken from: https://gist.github.com/wqli78/1330293/6d85cc967f32cccfcbad94ae7d088a3dcfc14bd9
- *
- * @param {String} str
- * @param {Boolean} hex
- * @return {String} checksum
- * @api public
- */
-
-export function crc32(str) {
-	let crc = ~0;
-	let buf = Buffer.from( str );
-
-	let i = 0,
-		l = buf.length;
-	while( i<l ) {
-        crc = (crc >>> 8) ^ crc32tab[(crc ^ buf[i]) & 0xff];
-		i++;
-    }
-
-    return (crc ^ -1)>>>0;
-}
-
-var crc32tab = new Int32Array([
-	0x00000000, 0x77073096, 0xee0e612c, 0x990951ba,
-	0x076dc419, 0x706af48f, 0xe963a535, 0x9e6495a3,
-	0x0edb8832, 0x79dcb8a4, 0xe0d5e91e, 0x97d2d988,
-	0x09b64c2b, 0x7eb17cbd, 0xe7b82d07, 0x90bf1d91,
-	0x1db71064, 0x6ab020f2, 0xf3b97148, 0x84be41de,
-	0x1adad47d, 0x6ddde4eb, 0xf4d4b551, 0x83d385c7,
-	0x136c9856, 0x646ba8c0, 0xfd62f97a, 0x8a65c9ec,
-	0x14015c4f, 0x63066cd9, 0xfa0f3d63, 0x8d080df5,
-	0x3b6e20c8, 0x4c69105e, 0xd56041e4, 0xa2677172,
-	0x3c03e4d1, 0x4b04d447, 0xd20d85fd, 0xa50ab56b,
-	0x35b5a8fa, 0x42b2986c, 0xdbbbc9d6, 0xacbcf940,
-	0x32d86ce3, 0x45df5c75, 0xdcd60dcf, 0xabd13d59,
-	0x26d930ac, 0x51de003a, 0xc8d75180, 0xbfd06116,
-	0x21b4f4b5, 0x56b3c423, 0xcfba9599, 0xb8bda50f,
-	0x2802b89e, 0x5f058808, 0xc60cd9b2, 0xb10be924,
-	0x2f6f7c87, 0x58684c11, 0xc1611dab, 0xb6662d3d,
-	0x76dc4190, 0x01db7106, 0x98d220bc, 0xefd5102a,
-	0x71b18589, 0x06b6b51f, 0x9fbfe4a5, 0xe8b8d433,
-	0x7807c9a2, 0x0f00f934, 0x9609a88e, 0xe10e9818,
-	0x7f6a0dbb, 0x086d3d2d, 0x91646c97, 0xe6635c01,
-	0x6b6b51f4, 0x1c6c6162, 0x856530d8, 0xf262004e,
-	0x6c0695ed, 0x1b01a57b, 0x8208f4c1, 0xf50fc457,
-	0x65b0d9c6, 0x12b7e950, 0x8bbeb8ea, 0xfcb9887c,
-	0x62dd1ddf, 0x15da2d49, 0x8cd37cf3, 0xfbd44c65,
-	0x4db26158, 0x3ab551ce, 0xa3bc0074, 0xd4bb30e2,
-	0x4adfa541, 0x3dd895d7, 0xa4d1c46d, 0xd3d6f4fb,
-	0x4369e96a, 0x346ed9fc, 0xad678846, 0xda60b8d0,
-	0x44042d73, 0x33031de5, 0xaa0a4c5f, 0xdd0d7cc9,
-	0x5005713c, 0x270241aa, 0xbe0b1010, 0xc90c2086,
-	0x5768b525, 0x206f85b3, 0xb966d409, 0xce61e49f,
-	0x5edef90e, 0x29d9c998, 0xb0d09822, 0xc7d7a8b4,
-	0x59b33d17, 0x2eb40d81, 0xb7bd5c3b, 0xc0ba6cad,
-	0xedb88320, 0x9abfb3b6, 0x03b6e20c, 0x74b1d29a,
-	0xead54739, 0x9dd277af, 0x04db2615, 0x73dc1683,
-	0xe3630b12, 0x94643b84, 0x0d6d6a3e, 0x7a6a5aa8,
-	0xe40ecf0b, 0x9309ff9d, 0x0a00ae27, 0x7d079eb1,
-	0xf00f9344, 0x8708a3d2, 0x1e01f268, 0x6906c2fe,
-	0xf762575d, 0x806567cb, 0x196c3671, 0x6e6b06e7,
-	0xfed41b76, 0x89d32be0, 0x10da7a5a, 0x67dd4acc,
-	0xf9b9df6f, 0x8ebeeff9, 0x17b7be43, 0x60b08ed5,
-	0xd6d6a3e8, 0xa1d1937e, 0x38d8c2c4, 0x4fdff252,
-	0xd1bb67f1, 0xa6bc5767, 0x3fb506dd, 0x48b2364b,
-	0xd80d2bda, 0xaf0a1b4c, 0x36034af6, 0x41047a60,
-	0xdf60efc3, 0xa867df55, 0x316e8eef, 0x4669be79,
-	0xcb61b38c, 0xbc66831a, 0x256fd2a0, 0x5268e236,
-	0xcc0c7795, 0xbb0b4703, 0x220216b9, 0x5505262f,
-	0xc5ba3bbe, 0xb2bd0b28, 0x2bb45a92, 0x5cb36a04,
-	0xc2d7ffa7, 0xb5d0cf31, 0x2cd99e8b, 0x5bdeae1d,
-	0x9b64c2b0, 0xec63f226, 0x756aa39c, 0x026d930a,
-	0x9c0906a9, 0xeb0e363f, 0x72076785, 0x05005713,
-	0x95bf4a82, 0xe2b87a14, 0x7bb12bae, 0x0cb61b38,
-	0x92d28e9b, 0xe5d5be0d, 0x7cdcefb7, 0x0bdbdf21,
-	0x86d3d2d4, 0xf1d4e242, 0x68ddb3f8, 0x1fda836e,
-	0x81be16cd, 0xf6b9265b, 0x6fb077e1, 0x18b74777,
-	0x88085ae6, 0xff0f6a70, 0x66063bca, 0x11010b5c,
-	0x8f659eff, 0xf862ae69, 0x616bffd3, 0x166ccf45,
-	0xa00ae278, 0xd70dd2ee, 0x4e048354, 0x3903b3c2,
-	0xa7672661, 0xd06016f7, 0x4969474d, 0x3e6e77db,
-	0xaed16a4a, 0xd9d65adc, 0x40df0b66, 0x37d83bf0,
-	0xa9bcae53, 0xdebb9ec5, 0x47b2cf7f, 0x30b5ffe9,
-	0xbdbdf21c, 0xcabac28a, 0x53b39330, 0x24b4a3a6,
-	0xbad03605, 0xcdd70693, 0x54de5729, 0x23d967bf,
-	0xb3667a2e, 0xc4614ab8, 0x5d681b02, 0x2a6f2b94,
-	0xb40bbe37, 0xc30c8ea1, 0x5a05df1b, 0x2d02ef8d
-]);
-
-
-// :: MIXINS ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
-
-/**
- * taken from this excellent article:
- *	https://justinfagnani.com/2015/12/21/real-mixins-with-javascript-classes/
- *
- * @example:
- *	class MyClass extends mix(MyBaseClass).with(Mixin1, Mixin2) {
- *  }
- **/
-
-export const mix = (superclass) => new MixinBuilder(superclass);
-
-class MixinBuilder {
-
-	private superclass: any;
-
-	constructor(superclass) {
-		this.superclass = superclass;
-	}
-
-	with(...mixins) {
-		return mixins.reduce((c, mixin) => mixin(c), this.superclass);
-	}
-}
-
-/**
- * @example
- * 
- * ```
- * 	const cls = classNames( 'class1 class2', {
- * 		'class3': false,
- * 		'class4': true,
- *  });
- * 
- *  // even shorter
- *  const class1 = true, class2 = false;
- *  const cls = classNames( { class1, class2 } );  // cls = "class1"
- * 
- * ```
- * 
- * @returns 
- */
-
-export function classNames(...args: (string | any)[]) {
-
-	let result = '';
-
-	for (const cls of args) {
-		if (typeof cls === 'string') {
-			result += ' ' + cls;
-		}
-		else if (cls) {
-			for (const c in cls) {
-				if (cls[c])
-					result += ' ' + c;
-			}
-		}
-	}
-
-	return result;
-}
-
-/**
- * 
- */
-
-interface PasswordRule {
-	chars: string;
-	min: number;
-}
-
-export function generatePassword(length: number, rules?: PasswordRule[]) {
-
-	if (!length || length == undefined) {
-		length = 8;
-	}
-
-	if (!rules) {
-		rules = [
-			{ chars: "abcdefghijklmnopqrstuvwxyz", min: 3 },  // As least 3 lowercase letters
-			{ chars: "ABCDEFGHIJKLMNOPQRSTUVWXYZ", min: 2 },  // At least 2 uppercase letters
-			{ chars: "0123456789", min: 2 },                  // At least 2 digits
-			{ chars: "!@#$*|%+-_.;", min: 2 }      // At least 1 special char
-		];
-	}
-
-	let allChars = "";
-	let allMin = 0;
-
-	rules.forEach(function (rule) {
-		allChars += rule.chars;
-		allMin += rule.min;
-	});
-
-	if (length < allMin) {
-		length = allMin;
-	}
-
-	rules.push({ chars: allChars, min: length - allMin });
-
-	let pswd = "";
-	rules.forEach(function (rule) {
-		if (rule.min > 0) {
-			pswd += shuffle(rule.chars, rule.min);
-		}
-	});
-
-	return shuffle(pswd);
-}
-
-function shuffle(str: string, maxlength?: number) {
-	let shuffled = str.split('').sort(() => {
-		return 0.5 - Math.random()
-	}).join('');
-
-	if (maxlength > 0) {
-		shuffled = shuffled.substr(0, maxlength);
-	}
-
-	return shuffled;
-}
-
-
-
-/**
- * taken from live-server 
- * https://github.com/tapio/live-server
- * @param host 
- * @param port 
- */
- 
-export function installHMR(host = "127.0.0.1", port = "9876", reloadCallback?: Function ) {
-
-	let tm;
-
-	function refreshCSS() {
-
-		document.body.style.visibility = "hidden";
-
-		let sheets = [].slice.call(document.getElementsByTagName("link"));
-		let head = document.getElementsByTagName("head")[0];
-		
-		for (let i = 0; i < sheets.length; ++i) {
-			let elem = sheets[i];
-			head.removeChild(elem);
-
-			let rel = elem.rel;
-			if (elem.href && typeof rel != "string" || rel.length == 0 || rel.toLowerCase() == "stylesheet") {
-				let url = elem.href.replace(/(&|\?)_cacheOverride=\d+/, '');
-				elem.href = url + (url.indexOf('?') >= 0 ? '&' : '?') + '_cacheOverride=' + (new Date().valueOf());
-			}
-			
-			head.appendChild(elem);
-		}
-
-		if( tm ) { clearTimeout(tm); }
-		tm = setTimeout( () => {
-			document.body.style.visibility = "unset";
-		}, 50 );
-	}
-
-	const protocol = window.location.protocol === 'https:' ? 'wss://' : 'ws://';
-	const address = `${protocol}${host}:${port}/ws`;	
-	const socket = new WebSocket(address);
-
-	socket.onmessage = function (msg) {
-		if (msg.data == 'reload') {
-			if( reloadCallback ) {
-				reloadCallback( );
-			}
-			else {
-				window.location.reload();
-			}
-		}
-		else if (msg.data == 'refreshcss') {
-			refreshCSS();
-		}
-	};
-
-	console.log('Live reload enabled.');
-}