x4js 1.4.3 → 1.4.4

package/lib/styles.js

@@ -1,262 +0,0 @@
-/**
-*  ___   ___ __
-*  \  \_/  /  / _
-*   \     /  /_| |_
-*   /  _  \____   _|
-*  /__/ \__\   |_|
-*
-* @file styles.ts
-* @author Etienne Cochard
-* @license
-* Copyright (c) 2019-2021 R-libre ingenierie
-*
-* This program is free software; you can redistribute it and/or modify
-* it under the terms of the GNU General Public License as published by
-* the Free Software Foundation; either version 3 of the License, or
-* (at your option) any later version.
-*
-* This program is distributed in the hope that it will be useful,
-* but WITHOUT ANY WARRANTY; without even the implied warranty of
-* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-* GNU General Public License for more details.
-*
-* You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
-**/
-import { pascalCase, isString, isArray } from "./tools";
-/**
- *  -- [ @STYLESHEET ] -----------------------------------------------------------------
- */
-export class Stylesheet {
-    m_sheet;
-    m_rules = new Map();
-    constructor() {
-        function getStyleSheet(name) {
-            for (let i = 0; i < document.styleSheets.length; i++) {
-                let sheet = document.styleSheets[i];
-                if (sheet.title === name) {
-                    return sheet;
-                }
-            }
-        }
-        this.m_sheet = getStyleSheet('@dynamic-css');
-        if (!this.m_sheet) {
-            let dom = document.createElement('style');
-            dom.setAttribute('id', '@dynamic-css');
-            document.head.appendChild(dom);
-            this.m_sheet = dom.sheet;
-        }
-    }
-    /**
-     * add a new rule to the style sheet
-     * @param {string} name - internal rule name
-     * @param {string} definition - css definition of the rule
-     * @example
-     * setRule('xbody', "body { background-color: #ff0000; }" );
-     */
-    setRule(name, definition) {
-        if (isString(definition)) {
-            let index = this.m_rules.get(name);
-            if (index !== undefined) {
-                this.m_sheet.deleteRule(index);
-            }
-            else {
-                index = this.m_sheet.cssRules.length;
-            }
-            this.m_rules.set(name, this.m_sheet.insertRule(definition, index));
-        }
-        else {
-            let idx = 1;
-            for (let r in definition) {
-                let rule = r + " { ", css = definition[r];
-                for (let i in css) {
-                    let values = css[i]; // this is an array !
-                    for (let j = 0; j < values.length; j++) {
-                        rule += i + ": " + values[j] + "; ";
-                    }
-                }
-                rule += '}';
-                console.log(rule);
-                this.setRule(name + '--' + idx, rule);
-                idx++;
-            }
-        }
-    }
-    /**
-     * return the style variable value
-     * @param name - variable name without '--'
-     * @example
-     * ```
-     * let color = Component.getCss( ).getVar( 'button-color' );
-     * ```
-     */
-    static getVar(name) {
-        if (!Stylesheet.doc_style) {
-            Stylesheet.doc_style = getComputedStyle(document.documentElement);
-        }
-        return Stylesheet.doc_style.getPropertyValue('--' + name); // #999999
-    }
-    static guid = 1;
-    static doc_style;
-}
-/**
- *  -- [ @CSSPARSER ] -----------------------------------------------------------------
- *
- * adaptation of jss-for-node-js
- */
-export class CSSParser {
-    result = {};
-    parse(css) {
-        this.result = {};
-        this.parse_json('', css);
-        return CSSParser.mk_string(this.result);
-    }
-    static mk_string(rules) {
-        // output result:	
-        let ret = '';
-        for (let a in rules) {
-            let css = rules[a];
-            ret += a + " { ";
-            for (let i in css) {
-                let values = css[i]; // this is an array !
-                for (let j = 0; j < values.length; j++) {
-                    ret += i + ": " + values[j] + "; ";
-                }
-            }
-            ret += "}\n";
-        }
-        return ret;
-    }
-    parse_json(scope, css) {
-        if (scope && !this.result[scope]) {
-            this.result[scope] = {};
-        }
-        for (let property in css) {
-            let value = css[property];
-            if (isArray(value)) {
-                let values = value;
-                for (let i = 0; i < values.length; i++) {
-                    this.addProperty(scope, property, values[i]);
-                }
-            }
-            /*else if (value instanceof Color) {
-                this.addProperty(scope, property, value.toString());
-            }*/
-            else {
-                switch (typeof (value)) {
-                    case "number": {
-                        this.addProperty(scope, property, value);
-                        break;
-                    }
-                    case "string": {
-                        this.addProperty(scope, property, value);
-                        break;
-                    }
-                    case "object": {
-                        this.parse_json(this.makeSelectorName(scope, property), value);
-                        break;
-                    }
-                    default: {
-                        console.error("ignoring unknown type " + typeof (value) + " in property " + property);
-                        break;
-                    }
-                }
-            }
-        }
-    }
-    makePropertyName(n) {
-        return pascalCase(n);
-    }
-    makeSelectorName(scope, name) {
-        let snames = [];
-        let names = name.split(/\s*,\s*/);
-        let scopes = scope.split(/\s*,\s*/);
-        for (let s = 0; s < scopes.length; s++) {
-            let scope = scopes[s];
-            for (let i = 0; i < names.length; i++) {
-                let name = names[i], sub = false;
-                if (name.charAt(0) == "&") {
-                    name = name.substr(1);
-                    sub = true;
-                }
-                if (name.charAt(0) === '%') {
-                    name = '.o-' + name.substr(1);
-                }
-                if (sub) {
-                    snames.push(scope + name);
-                }
-                else {
-                    snames.push(scope ? scope + " " + name : name);
-                }
-            }
-        }
-        return snames.join(", ");
-    }
-    addProperty(scope, property, value) {
-        let properties = property.split(/\s*,\s*/);
-        for (let i = 0; i < properties.length; i++) {
-            let property = this.makePropertyName(properties[i]);
-            if (this.result[scope][property]) {
-                this.result[scope][property].push(value);
-            }
-            else {
-                this.result[scope][property] = [value];
-            }
-            let specials = {
-                "box-shadow": [
-                    "-moz-box-shadow",
-                    "-webkit-box-shadow"
-                ],
-                "border-radius": [
-                    "-moz-border-radius",
-                    "-webkit-border-radius"
-                ],
-                "border-radius-topleft": [
-                    "-moz-border-radius-topleft",
-                    "-webkit-border-top-left-radius"
-                ],
-                "border-radius-topright": [
-                    "-moz-border-radius-topright",
-                    "-webkit-border-top-right-radius"
-                ],
-                "border-radius-bottomleft": [
-                    "-moz-border-radius-bottomleft",
-                    "-webkit-border-bottom-left-radius"
-                ],
-                "border-radius-bottomright": [
-                    "-moz-border-radius-bottomright",
-                    "-webkit-border-bottom-right-radius"
-                ]
-            };
-            let browser_specials = specials[property];
-            for (let j = 0; browser_specials && j < browser_specials.length; j++) {
-                this.addProperty(scope, browser_specials[j], value);
-            }
-        }
-    }
-}
-export class ComputedStyle {
-    m_style;
-    constructor(style) {
-        this.m_style = style;
-    }
-    /**
-     * return the raw value
-     */
-    value(name) {
-        name = pascalCase(name);
-        return this.m_style[name];
-    }
-    /**
-     * return the interpreted value
-     */
-    parse(name) {
-        name = pascalCase(name);
-        return parseInt(this.m_style[name]);
-    }
-    /**
-     *
-     */
-    get style() {
-        return this.m_style;
-    }
-}

package/lib/tools.d.ts

@@ -1,382 +0,0 @@
-/**
-*  ___   ___ __
-*  \  \_/  /  / _
-*   \     /  /_| |_
-*   /  _  \____   _|
-*  /__/ \__\   |_|
-*
-* @file tools.ts
-* @author Etienne Cochard
-* @license
-* Copyright (c) 2019-2021 R-libre ingenierie
-*
-* This program is free software; you can redistribute it and/or modify
-* it under the terms of the GNU General Public License as published by
-* the Free Software Foundation; either version 3 of the License, or
-* (at your option) any later version.
-*
-* This program is distributed in the hope that it will be useful,
-* but WITHOUT ANY WARRANTY; without even the implied warranty of
-* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-* GNU General Public License for more details.
-*
-* You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
-**/
-/**
- * @return true is the device has touch
- */
-export declare function isTouchDevice(): boolean;
-/**
- * round to a given number of decimals
- * @param num numbre to round
- * @param ndec number of decimals
- * @returns number rounded
- */
-export declare function roundTo(num: number, ndec: number): number;
-/**
- * parse an intl formatted number
- * understand grouping and ',' separator
- * @review us format: grouping = ','
- * @param num
- */
-export declare function parseIntlFloat(num: string): number;
-/**
- * inverse of camel case
- * theThingToCase -> the-thing-to-case
- * @param {String} str
- */
-export declare function pascalCase(string: string): string;
-export declare type Constructor<T> = new (...args: any[]) => T;
-export declare class Point {
-    x: number;
-    y: number;
-    constructor(x?: number, y?: number);
-}
-export declare class Size {
-    width: number;
-    height: number;
-    constructor(w?: number, h?: number);
-}
-export declare 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);
-    set(left: number, top: number, width: number, height: number): void;
-    get bottom(): number;
-    set bottom(bottom: number);
-    get right(): number;
-    set right(right: number);
-    get topLeft(): Point;
-    get bottomRight(): Point;
-    get size(): Size;
-    moveTo(left: number, top: number): this;
-    movedTo(left: number, top: number): Rect;
-    moveBy(dx: number, dy: number): this;
-    movedBy(dx: number, dy: number): Rect;
-    isEmpty(): boolean;
-    normalize(): this;
-    normalized(): Rect;
-    /**
-     * @deprecated
-     */
-    containsPt(x: number, y: number): boolean;
-    contains(pt: Point): boolean;
-    contains(rc: Rect): boolean;
-    touches(rc: Rect): boolean;
-    inflate(dx: number, dy?: number): void;
-    inflatedBy(dx: number, dy?: number): Rect;
-    combine(rc: Rect): void;
-}
-/**
- * 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 declare function sprintf(format: string, ...args: any[]): string;
-/**
- * replace special characters for display
- * @param unsafe
- *
- * console.log( escapeHtml('<div style="width:50px; height: 50px; background-color:red"></div>') );
- */
-export declare function escapeHtml(unsafe: string, nl_br?: boolean): string;
-/**
- * replace special characters for display
- * @author Steven Levithan <http://slevithan.com/>
- * @param unsafe
- *
- * console.log( removeHtmlTags('<h1>sss</h1>') );
- */
-export declare function removeHtmlTags(unsafe: string, nl_br?: boolean): string;
-/**
- * change the current locale for misc translations (date...)
- * @param locale
- */
-export declare function _date_set_locale(locale: string): void;
-/**
- *
- * @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 declare function date_format(date: Date, options?: any): string;
-/**
- *
- * @param date
- * @param options
- */
-export declare function date_diff(date1: Date, date2: Date, options?: any): string;
-export declare function date_to_sql(date: Date, withHours: boolean): string;
-/**
- * construct a date from an utc date time (sql format)
- * YYYY-MM-DD HH:MM:SS
- */
-export declare function date_sql_utc(date: string): Date;
-/**
- * return a number that is a representation of the date
- * this number can be compared with another hash
- */
-export declare function date_hash(date: Date): number;
-/**
- * return a copy of a date
- */
-export declare function date_clone(date: Date): Date;
-/**
- * return the week number of a date
- */
-export declare function date_calc_weeknum(date: Date): number;
-/**
- * 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 declare function parseIntlDate(value: string, fmts?: string): Date;
-/**
- * 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 declare function formatIntlDate(date: Date, fmt?: string): string;
-export declare function calcAge(birth: Date, ref?: Date): number;
-/**
- * date object patch
- */
-declare global {
-    interface Date {
-        hash(): number;
-        clone(): Date;
-        weekNum(): number;
-        format(format: string): string;
-        isSameDay(date: Date): boolean;
-        addDays(days: number): any;
-    }
-}
-/**
- *
- * @param data data to export
- * @param mimetype - 'text/plain'
- */
-export declare function downloadData(data: any, mimetype: string, filename: string): void;
-/**
- * check if a value is a string
- * @param val
- */
-export declare function isString(val: any): val is string;
-/**
- * check is a value is an array
- * @param val
- */
-export declare function isArray(val: any): val is any[];
-/**
- *
- */
-export declare function isFunction(val: any): val is Function;
-/**
- *
- */
-export declare function isLiteralObject(val: any): boolean;
-/**
- * prepend 0 to a value to a given length
- * @param value
- * @param length
- */
-export declare function pad(what: unknown, size: number, ch?: string): string;
-/**
- * return true if val is a finite number
- */
-export declare function isNumber(val: any): val is number;
-/**
- *
- * @param name
- */
-export declare function waitFontLoading(name: string): Promise<void>;
-/**
- *
- * @param fn
- * @param tm
- *
- * @example:
- *
- * defer( ( ) => {
- * 	console.log( x );
- * } )(  );
- */
-export declare function deferCall(fn: Function, tm?: number, ...args: any[]): void;
-/**
- *
- */
-export declare function asap(cb: (time: number) => void): void;
-/**
- * micro md to html
- *
- * understand:
- * 	**bold**
- * 	*italic*
- *
- *  > quote
- *  - list
- *  # title lvl 1
- *  ## title lvl 2
- *  ### title lvl 3 ...
- *
- */
-export declare function markdownToHtml(text: string): string;
-/**
- *
- */
-export declare class NetworkError extends Error {
-    private m_code;
-    constructor(response: Response);
-    constructor(code: number, text: string);
-    get code(): number;
-}
-/**
- * return the mouse pos in client coordinates
- * handle correctly touch & mouse
- */
-export declare function getMousePos(ev: UIEvent, fromDoc: boolean): Point;
-/**
- * clamp a value
- * @param v - value to clamp
- * @param min - min value
- * @param max - max value
- * @returns clamped value
- */
-export declare function clamp(v: number, min: number, max: number): number;
-/**
- *
- */
-export interface IDisposable {
-    dispose(): any;
-}
-export declare class HtmlString extends String {
-    constructor(text: string);
-    static from(text: string): HtmlString;
-}
-export declare function html(a: any, ...b: any[]): HtmlString;
-export declare function isHtmlString(val: any): val is HtmlString;
-export declare class Clipboard {
-    static copy(data: any): void;
-    static paste(cb: (data: string) => void): void;
-}
-/**
- * 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 declare function crc32(str: any): number;
-/**
- * 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 declare const mix: (superclass: any) => MixinBuilder;
-declare class MixinBuilder {
-    private superclass;
-    constructor(superclass: any);
-    with(...mixins: any[]): any;
-}
-/**
- * @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 declare function classNames(...args: (string | any)[]): string;
-/**
- *
- */
-interface PasswordRule {
-    chars: string;
-    min: number;
-}
-export declare function generatePassword(length: number, rules?: PasswordRule[]): string;
-export {};