TeaWeb/shared/js/proto.ts

447 lines
14 KiB
TypeScript

/* setup jsrenderer */
import "jsrender";
import { tr } from "./i18n/localize";
import { LogCategory, logError, logTrace } from "tc-shared/log";
(window as any).$ = require("jquery");
(window as any).jQuery = $;
require("jsrender")($);
declare global {
function setInterval(handler: TimerHandler, timeout?: number, ...arguments: any[]): number;
function setTimeout(handler: TimerHandler, timeout?: number, ...arguments: any[]): number;
interface Array<T> {
remove(elem?: T): boolean;
last?(): T;
pop_front(): T | undefined;
/**
* @param entry The entry to toggle
* @returns `true` if the entry has been inserted and false if the entry has been deleted
*/
toggle(entry: T): boolean;
/**
* @param entry The entry to toggle
* @param insert Whatever the entry should be in the array or not
* @returns `true` if the array has been modified
*/
toggle(entry: T, insert: boolean);
}
interface JSON {
map_to<T>(object: T, json: any, variables?: string | string[], validator?: (map_field: string, map_value: string) => boolean, variable_direction?: number): number;
map_field_to<T>(object: T, value: any, field: string): boolean;
}
type JQueryScrollType = "height" | "width";
interface JQuery<TElement = HTMLElement> {
renderTag(values?: any): JQuery<TElement>;
hasScrollBar(direction?: JQueryScrollType): boolean;
visible_height(): number;
visible_width(): number;
/* first element which matches the selector, could be the element itself or a parent */
firstParent(selector: string): JQuery;
}
interface JQueryStatic<TElement extends Node = HTMLElement> {
spawn<K extends keyof HTMLElementTagNameMap>(tagName: K): JQuery<HTMLElementTagNameMap[K]>;
}
interface Window {
__REACT_DEVTOOLS_GLOBAL_HOOK__: any;
readonly webkitAudioContext: typeof AudioContext;
readonly AudioContext: typeof OfflineAudioContext;
readonly OfflineAudioContext: typeof OfflineAudioContext;
readonly webkitOfflineAudioContext: typeof OfflineAudioContext;
readonly RTCPeerConnection: typeof RTCPeerConnection;
readonly Pointer_stringify: any;
readonly require: typeof require;
}
const __non_webpack_require__: typeof require;
interface Navigator {
browserSpecs: {
name: string,
version: string
};
}
interface ObjectConstructor {
isSimilar(a: any, b: any): boolean;
}
}
export type IfEquals<X, Y, A = X, B = never> =
(<T>() => T extends X ? 1 : 2) extends
(<T>() => T extends Y ? 1 : 2) ? A : B;
export type WritableKeys<T> = {
[P in keyof T]-?: IfEquals<{ [Q in P]: T[P] }, { -readonly [Q in P]: T[P] }, P, never>
}[keyof T];
export type ReadonlyKeys<T> = {
[P in keyof T]: IfEquals<{ [Q in P]: T[P] }, { -readonly [Q in P]: T[P] }, never, P>
}[keyof T];
if (!Object.isSimilar) {
Object.isSimilar = function (a, b) {
const aType = typeof a;
const bType = typeof b;
if (aType !== bType) {
return false;
}
if (aType === "object") {
const aKeys = Object.keys(a);
const bKeys = Object.keys(b);
if (aKeys.length != bKeys.length) { return false; }
if (aKeys.findIndex(key => bKeys.indexOf(key) !== -1) !== -1) { return false; }
return aKeys.findIndex(key => !Object.isSimilar(a[key], b[key])) === -1;
} else {
return a === b;
}
};
}
if (!JSON.map_to) {
JSON.map_to = function <T>(object: T, json: any, variables?: string | string[], validator?: (map_field: string, map_value: string) => boolean, variable_direction?: number): number {
if (!validator)
validator = () => true;
if (!variables) {
variables = [];
if (!variable_direction || variable_direction == 0) {
for (let field of Object.keys(json))
variables.push(field);
} else if (variable_direction == 1) {
for (let field of Object.keys(json))
variables.push(field);
}
} else if (!Array.isArray(variables)) {
variables = [variables];
}
let updates = 0;
for (let field of variables) {
if (typeof json[field] === "undefined") {
logTrace(LogCategory.GENERAL, tr("Json does not contains %s"), field);
continue;
}
if (!validator(field, json[field])) {
logTrace(LogCategory.GENERAL, tr("Validator results in false for %s"), field);
continue;
}
if (JSON.map_field_to(object, json[field], field))
updates++;
}
return updates;
}
}
if (!JSON.map_field_to) {
JSON.map_field_to = function <T>(object: T, value: any, field: string): boolean {
let fieldType = typeof object[field];
let newValue;
if (fieldType == "string" || fieldType == "object" || fieldType == "undefined") {
newValue = value;
} else if (fieldType == "number") {
newValue = parseFloat(value);
} else if (fieldType == "boolean") {
newValue = typeof value === "boolean" && value || value === "1" || value === "true";
} else {
console.warn(tr("Invalid object type %s for entry %s"), fieldType, field);
return false;
}
if (newValue === object[field]) {
return false;
}
object[field] = newValue;
return true;
}
}
if (!Array.prototype.remove) {
Array.prototype.remove = function <T>(elem?: T): boolean {
const index = this.indexOf(elem);
if (index > -1) {
this.splice(index, 1);
return true;
}
return false;
}
}
if (!Array.prototype.pop_front) {
Array.prototype.pop_front = function <T>(): T {
if (this.length == 0) return undefined;
return this.splice(0, 1)[0];
}
}
if (!Array.prototype.toggle) {
Array.prototype.toggle = function <T>(element: T, insert?: boolean): boolean {
const index = this.findIndex(e => e === element);
if ((index !== -1) === insert) {
return false;
} else if (index === -1) {
this.push(element);
return true;
} else {
this.splice(index, 1);
return typeof insert === "boolean";
}
}
}
if (!Array.prototype.last) {
Array.prototype.last = function () {
if (this.length == 0) return undefined;
return this[this.length - 1];
};
}
if (typeof ($) !== "undefined") {
if (!$.spawn) {
$.spawn = function <K extends keyof HTMLElementTagNameMap>(tagName: K): JQuery<HTMLElementTagNameMap[K]> {
return $(document.createElement(tagName) as any);
}
}
if (!$.fn.renderTag) {
$.fn.renderTag = function (this: JQuery, values?: any): JQuery {
let result;
const template = $.views.templates[this.attr("id")];
if (!template) {
console.error("Tried to render template %o, but template is not available!", this.attr("id"));
throw "missing template " + this.attr("id");
}
/*
result = window.jsrender.templates("tmpl_permission_entry", $("#tmpl_permission_entry").html());
result = window.jsrender.templates("xxx", this.html());
*/
result = template(values);
result = $(result);
result.find("node").each((index, element) => {
$(element).replaceWith(values[$(element).attr("key")] || (values[0] || [])[$(element).attr("key")]);
});
return result;
}
}
if (!$.fn.hasScrollBar)
$.fn.hasScrollBar = function (direction?: "height" | "width") {
if (this.length <= 0)
return false;
const scroll_height = this.get(0).scrollHeight > this.height();
const scroll_width = this.get(0).scrollWidth > this.width();
if (typeof (direction) === "string") {
if (direction === "height")
return scroll_height;
if (direction === "width")
return scroll_width;
}
return scroll_width || scroll_height;
};
if (!$.fn.visible_height)
$.fn.visible_height = function (this: JQuery<HTMLElement>) {
const original_style = this.attr("style");
this.css({
position: 'absolute!important',
visibility: 'hidden!important',
display: 'block!important'
});
const result = this.height();
this.attr("style", original_style || "");
return result;
};
if (!$.fn.visible_width)
$.fn.visible_width = function (this: JQuery<HTMLElement>) {
const original_style = this.attr("style");
this.css({
position: 'absolute!important',
visibility: 'hidden!important',
display: 'block!important'
});
const result = this.width();
this.attr("style", original_style || "");
return result;
};
if (!$.fn.firstParent)
$.fn.firstParent = function (this: JQuery<HTMLElement>, selector: string) {
if (this.is(selector))
return this;
return this.parent(selector);
}
}
if (!Object.values) {
Object.values = object => Object.keys(object).map(e => object[e]);
}
export function crashOnThrow<T>(promise: Promise<T> | (() => Promise<T>)): Promise<T> {
if (typeof promise === "function") {
try {
promise = promise();
} catch (error) {
promise = Promise.reject(error);
}
}
return promise.catch(error => {
/* TODO: Crash screen of the app? */
logError(LogCategory.GENERAL, tr("Critical app error: %o"), error);
/* Lets make this promise stuck for ever */
return new Promise(() => { });
});
}
export function ignorePromise<T>(_promise: Promise<T>) { }
export function NoThrow(target: any, methodName: string, descriptor: PropertyDescriptor) {
const crashApp = error => {
/* TODO: Crash screen of the app? */
logError(LogCategory.GENERAL, tr("Critical app error: %o"), error);
};
const promiseAccepted = { value: false };
const originalMethod: Function = descriptor.value;
descriptor.value = function () {
try {
const result = originalMethod.apply(this, arguments);
if (result instanceof Promise) {
promiseAccepted.value = true;
return result.catch(error => {
crashApp(error);
/* Lets make this promise stuck for ever since we're in a not well defined state */
return new Promise(() => { });
});
}
return result;
} catch (error) {
crashApp(error);
if (!promiseAccepted.value) {
throw error;
} else {
/*
* We don't know if we can return a promise or if just the object is expected.
* Since we don't know that, we're just rethrowing the error for now.
*/
return new Promise(() => { });
}
}
};
}
const kCallOnceSymbol = Symbol("call-once-data");
export function CallOnce(target: any, methodName: string, descriptor: PropertyDescriptor) {
const callOnceData = target[kCallOnceSymbol] || (target[kCallOnceSymbol] = {});
const originalMethod: Function = descriptor.value;
descriptor.value = function () {
if (callOnceData[methodName]) {
debugger;
throw "method " + methodName + " has already been called";
}
return originalMethod.apply(this, arguments);
};
}
const kNonNullSymbol = Symbol("non-null-data");
export function NonNull(target: any, methodName: string, parameterIndex: number) {
const nonNullInfo = target[kNonNullSymbol] || (target[kNonNullSymbol] = {});
const methodInfo = nonNullInfo[methodName] || (nonNullInfo[methodName] = {});
if (!Array.isArray(methodInfo.indexes)) {
/* Initialize method info */
methodInfo.overloaded = false;
methodInfo.indexes = [];
}
methodInfo.indexes.push(parameterIndex);
setImmediate(() => {
if (methodInfo.overloaded || methodInfo.missingWarned) {
return;
}
methodInfo.missingWarned = true;
logError(LogCategory.GENERAL, "Method %s has been constrained but the @Constrained decoration is missing.");
debugger;
});
}
/**
* The class or method has been constrained
*/
export function ParameterConstrained(target: any, methodName: string, descriptor: PropertyDescriptor) {
const nonNullInfo = target[kNonNullSymbol];
if (!nonNullInfo) {
return;
}
const methodInfo = nonNullInfo[methodName] || (nonNullInfo[methodName] = {});
if (!methodInfo) {
return;
}
methodInfo.overloaded = true;
const originalMethod: Function = descriptor.value;
descriptor.value = function () {
for (let index = 0; index < methodInfo.indexes.length; index++) {
const argument = arguments[methodInfo.indexes[index]];
if (typeof argument === undefined || typeof argument === null) {
throw "parameter " + methodInfo.indexes[index] + " should not be null or undefined";
}
}
return originalMethod.apply(this, arguments);
};
}
class TestClass {
@NoThrow
noThrow0() { }
@NoThrow
async noThrow1() {
await new Promise(resolve => setTimeout(resolve, 1));
}
@NoThrow
noThrow2() { throw "expected"; }
@NoThrow
async noThrow3() {
await new Promise(resolve => setTimeout(resolve, 1));
throw "expected";
}
@ParameterConstrained
nonNull0(@NonNull value: number) {
}
}
(window as any).TestClass = TestClass;