x4js 1.4.53 → 1.5.0

package/lib/ts_src/autocomplete.ts

@@ -0,0 +1,197 @@
+/**
+*  ___  ___ __
+*  \  \/  /  / _
+*   \    /  /_| |_
+*   /    \____   _|  
+*  /__/\__\   |_|
+*        
+* @file autocomplete.ts
+* @author Etienne Cochard 
+*
+* Copyright (c) 2019-2022 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 { ListViewItem, PopupListView } from "./listview";
+import { TextEdit, TextEditProps } from './textedit';
+
+/**
+ * 
+ */
+
+interface AutoCompleteProps extends TextEditProps {
+	enumValues: ( filter: string ) => string[];
+}
+
+/**
+ * 
+ */
+
+export class AutoComplete extends TextEdit<AutoCompleteProps> {
+	
+	private m_popup: PopupListView;
+	private m_popvis: boolean;
+	private m_needval: boolean;
+	private m_lockpop: boolean;
+	
+	constructor( props: AutoCompleteProps ) {
+		super( props );
+
+		this.setDomEvent( "input", ( ) => this._onChange( ) );
+		this.setDomEvent( "focusin", ( ) => this._onFocus( ) );
+		this.startTimer( "focus-check", 100, true, () => this._checkFocus() );
+
+		this.m_popvis = false;
+		this.m_needval = false;
+		this.m_lockpop = false;
+
+		this.setDomEvent( "keydown", e => this._onKey(e) );
+	}
+
+	_onKey( e: KeyboardEvent ) {
+		if( this.m_popvis ) {
+			if( e.key=="ArrowUp" || e.key=="ArrowDown" ) {
+				this.m_lockpop = true;
+				this.m_popup.handleKey( e );
+				this.m_lockpop = false;
+
+				e.preventDefault( );
+				e.stopPropagation( );
+			}
+			else if( e.key=="Escape" ) {
+				this._hidePopup( );
+
+				e.preventDefault( );
+				e.stopPropagation( );
+			}
+		}
+		else if( e.key=="ArrowDown" ) {
+			this._onChange( );
+			e.preventDefault( );
+			e.stopPropagation( );
+		}
+	}
+
+	private _onChange( ) {
+		const items = this.m_props.enumValues( this.value );
+		this.showPopup( items );
+	}
+
+	componentDisposed( ) {
+		if( this.m_popup ) {
+			this._hidePopup( );
+		}
+
+		super.componentDisposed( );
+	}
+
+	/** 
+	 * display the popup 
+	 */
+
+	showPopup( items: string[] ) {
+
+		let props = this.m_props;
+		if (props.readOnly || this.hasClass("@disable") ) {
+			return;
+		}
+
+		// need creation ?
+		
+		if( !this.m_popup ) {
+			let cstyle = this.getComputedStyle( );
+			let fontFamily = cstyle.value( 'fontFamily' );
+			let fontSize = cstyle.value( 'fontSize' );
+
+			// prepare the combo listview
+			this.m_popup = new PopupListView({
+				cls: '@combo-popup',
+				attrs: {
+					tabindex: 0
+				},
+				selectionChange: (e) => {
+					this.value = (e.selection as ListViewItem).id
+					if( !this.m_lockpop ) {
+						this._hidePopup( );
+						this.focus( );
+					}
+				},
+				style: {
+					fontFamily,
+					fontSize
+				}
+			});
+		}
+
+		this.m_popup.items = items.map( c => ({ id: c, text: c }) );
+	
+		let r1 = this.m_ui_input.getBoundingRect();
+		this.m_popup.setStyle({
+			minWidth: r1.width,
+		});
+
+		this.m_popup.displayAt(r1.left, r1.bottom);
+		this.m_popvis = true;
+		
+		//if( this.value!==undefined ) {
+		//	this.m_popup.selection = this.value;
+		//}
+	}
+
+	protected override _validate(value: string): boolean {
+		return true;
+	}
+
+	override validate( ): boolean {
+		return super._validate( this.value );
+	}
+
+	private _checkFocus( ) {
+		const focus = document.activeElement;
+		if( this.dom && this.dom.contains(focus) ) {
+			return;
+		}
+
+		if( this.m_popup && this.m_popup.dom && this.m_popup.dom.contains(focus) ) {
+			return;
+		}
+
+		this._hidePopup( );
+	}
+
+	private _hidePopup( ) {
+		
+		if( this.m_popvis ) {
+			this.m_popup.close();
+			this.m_popvis = false;
+		}
+
+		if( this.m_needval ) {
+			this.validate( );
+			this.m_needval = false;
+		}
+	}
+
+	private _onFocus( ) {
+		if( this.value.length==0 ) {
+			this._onChange( );
+		}
+
+		this.m_needval = true;
+	}
+}

package/lib/ts_src/base64.ts

@@ -0,0 +1,166 @@
+/**
+*  ___  ___ __
+*  \  \/  /  / _
+*   \    /  /_| |_
+*   /    \____   _|  
+*  /__/\__\   |_|
+*        
+* @file base64.ts
+* @author Etienne Cochard 
+*
+* Copyright (c) 2019-2022 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.
+**/
+
+const _alphabet: string = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=';
+let _lookup: any = null;
+
+
+export class Base64 {
+	lookup: any = null;
+
+	static encode(s: string | Uint8Array ) {
+		let buffer;
+
+		if( s instanceof Uint8Array ) {
+			buffer = []
+			s.forEach( (v) => {
+				buffer.push( v );
+			});
+		}
+		else {
+			buffer = Base64._toUtf8(s);
+		}
+
+		let position = -1;
+		let len = buffer.length;
+		let nan1, nan2;
+		let enc = [, , ,];
+
+		let result = '';
+		while (++position < len) {
+			nan1 = buffer[position + 1], nan2 = buffer[position + 2];
+			enc[0] = buffer[position] >> 2;
+			enc[1] = ((buffer[position] & 3) << 4) | (buffer[++position] >> 4);
+
+			if (isNaN(nan1)) {
+				enc[2] = enc[3] = 64;
+			}
+			else {
+				enc[2] = ((buffer[position] & 15) << 2) | (buffer[++position] >> 6);
+				enc[3] = (isNaN(nan2)) ? 64 : buffer[position] & 63;
+			}
+
+			result += _alphabet[enc[0]] + _alphabet[enc[1]] + _alphabet[enc[2]] + _alphabet[enc[3]];
+		}
+
+		return result;
+	}
+
+	static decode(s: string) {
+		let buffer = Base64._fromUtf8(s);
+
+		let position = 0;
+		let len = buffer.length;
+
+		let result = '';
+		while (position < len) {
+			if (buffer[position] < 128) {
+				result += String.fromCharCode(buffer[position++]);
+			}
+			else if (buffer[position] > 191 && buffer[position] < 224) {
+				result += String.fromCharCode(((buffer[position++] & 31) << 6) | (buffer[position++] & 63));
+			}
+			else {
+				result += String.fromCharCode(((buffer[position++] & 15) << 12) | ((buffer[position++] & 63) << 6) | (buffer[position++] & 63));
+			}
+		}
+
+		return result;
+	}
+
+	private static _toUtf8(s) {
+		let position = -1;
+		let len = s.length;
+
+		let chr;
+		let buffer = [];
+
+		if (/^[\x00-\x7f]*$/.test(s)) {
+			while (++position < len) {
+				buffer.push(s.charCodeAt(position));
+			}
+		}
+		else {
+			while (++position < len) {
+				chr = s.charCodeAt(position);
+				if (chr < 128) {
+					buffer.push(chr);
+				}
+				else if (chr < 2048) {
+					buffer.push((chr >> 6) | 192, (chr & 63) | 128);
+				}
+				else {
+					buffer.push((chr >> 12) | 224, ((chr >> 6) & 63) | 128, (chr & 63) | 128);
+				}
+			}
+		}
+
+		return buffer;
+	}
+
+	private static _fromUtf8(s) {
+		let position = -1;
+		let len;
+		let buffer = [];
+		let enc = [, , ,];
+
+		if (!_lookup) {
+			len = _alphabet.length;
+			_lookup = {};
+			while (++position < len) {
+				_lookup[_alphabet[position]] = position;
+			}
+
+			position = -1;
+		}
+
+		len = s.length;
+		while (position < len) {
+			enc[0] = _lookup[s.charAt(++position)];
+			enc[1] = _lookup[s.charAt(++position)];
+			buffer.push((enc[0] << 2) | (enc[1] >> 4));
+
+			enc[2] = _lookup[s.charAt(++position)];
+			if (enc[2] == 64) {
+				break;
+			}
+
+			buffer.push(((enc[1] & 15) << 4) | (enc[2] >> 2));
+			enc[3] = _lookup[s.charAt(++position)];
+
+			if (enc[3] == 64) {
+				break;
+			}
+
+			buffer.push(((enc[2] & 3) << 6) | enc[3]);
+		}
+
+		return buffer;
+	}
+}

package/lib/ts_src/base_component.ts

@@ -0,0 +1,152 @@
+/**
+*  ___  ___ __
+*  \  \/  /  / _
+*   \    /  /_| |_
+*   /    \____   _|  
+*  /__/\__\   |_|
+*        
+* @file base_component.ts
+* @author Etienne Cochard 
+*
+* Copyright (c) 2019-2022 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 { EventMap, MapEvents, EventSource, EvTimer } from './x4events';
+
+/**
+ * Timer Callback
+ * @see EvTimer, startTimer, stopTimer
+ */
+
+ interface TimerCallback {
+	(name: string, time: number): void;
+}
+
+/**
+ * BaseComponent EventMap
+ */
+
+export interface BaseComponentEventMap extends EventMap {
+	timer: EvTimer,
+}
+
+/**
+ * BaseCompoment Properties
+ */
+
+export interface BaseComponentProps<T = BaseComponentEventMap> {
+	events?: MapEvents<T>;	// basic component event map in base interface, should specialised in derived interfaces
+	[key: string]: any; // added index signature to solve "Type 'X' has no properties with type 'Y'" 
+}
+
+/**
+ * BaseComponent class
+ */
+
+export class BaseComponent< P extends BaseComponentProps<BaseComponentEventMap>, E extends BaseComponentEventMap >
+	extends EventSource< E > {
+
+	protected m_props: P;
+	#m_timers: Map<string, Function>;
+
+	constructor(props: P) {
+		super();
+
+		//this.m_props = { ...props };
+		this.m_props = props;
+
+		if (props.events) {
+			this.listen(props.events as EventMap);
+		}
+	}
+
+	/**
+	 * start a new timer
+	 * @param name timer name 
+	 * @param timeout time out in ms
+	 * @param repeat if true this is an auto repeat timer
+	 * @param callback if !null, the callback to call else a EvTimer is fired
+	 */
+
+	startTimer(name: string, timeout: number, repeat = true, callback: TimerCallback = null) {
+		if (!this.#m_timers) {
+			this.#m_timers = new Map();
+		}
+		else {
+			this.stopTimer(name);
+		}
+
+		const id = (repeat ? setInterval : setTimeout)((tm: number) => {
+			if (callback) {
+				callback(name, tm);
+			}
+			else {
+				this.emit('timer', EvTimer( name, tm ));
+			}
+		}, timeout);
+
+		this.#m_timers.set(name, () => { (repeat ? clearInterval : clearTimeout)(id) });
+	}
+
+	/**
+	 * stop the given timer
+	 * @param name 
+	 */
+
+	stopTimer(name: string) {
+		const clear = this.#m_timers.get(name);
+		if (clear) { clear(); }
+	}
+
+	/**
+	 * stop all timers
+	 */
+
+	disposeTimers( ) {
+		this.#m_timers?.forEach( v => v() );
+		this.#m_timers = undefined;
+	}
+
+	/**
+	 * 
+	 * @param callback 
+	 * @param timeout 
+	 */
+
+	singleShot( callback: TimerCallback, timeout = 0 ) {
+		setTimeout( callback, timeout );
+	}
+
+	/**
+	 * 
+	 * @param props 
+	 * @param elements 
+	 */
+	
+	public mapPropEvents<N extends keyof E>(props: P, ...elements: N[] ) {
+		elements.forEach( name => {
+			const n = name as string;
+			if (props[n]) {
+				this._on(n, props[n]);
+			}
+		})
+	}
+}
+