mirror of
				https://github.com/NativeScript/NativeScript.git
				synced 2025-11-04 12:58:38 +08:00 
			
		
		
		
	
		
			
				
	
	
		
			289 lines
		
	
	
		
			6.9 KiB
		
	
	
	
		
			TypeScript
		
	
	
	
	
	
			
		
		
	
	
			289 lines
		
	
	
		
			6.9 KiB
		
	
	
	
		
			TypeScript
		
	
	
	
	
	
import * as types from './types';
 | 
						|
import { dispatchToMainThread, dispatchToUIThread, isMainThread } from './mainthread-helper';
 | 
						|
import emojiRegex from 'emoji-regex';
 | 
						|
 | 
						|
import { GC } from './index';
 | 
						|
 | 
						|
export * from './mainthread-helper';
 | 
						|
export * from './macrotask-scheduler';
 | 
						|
 | 
						|
export const RESOURCE_PREFIX = 'res://';
 | 
						|
export const FILE_PREFIX = 'file:///';
 | 
						|
 | 
						|
export function escapeRegexSymbols(source: string): string {
 | 
						|
	const escapeRegex = /[\-\[\]\/\{\}\(\)\*\+\?\.\\\^\$\|]/g;
 | 
						|
 | 
						|
	return source.replace(escapeRegex, '\\$&');
 | 
						|
}
 | 
						|
 | 
						|
export function convertString(value: any): any {
 | 
						|
	let result;
 | 
						|
 | 
						|
	if (!types.isString(value) || value.trim() === '') {
 | 
						|
		result = value;
 | 
						|
	} else {
 | 
						|
		// Try to convert value to number.
 | 
						|
		const valueAsNumber = +value;
 | 
						|
		if (!isNaN(valueAsNumber)) {
 | 
						|
			result = valueAsNumber;
 | 
						|
		} else if (value && (value.toLowerCase() === 'true' || value.toLowerCase() === 'false')) {
 | 
						|
			result = value.toLowerCase() === 'true' ? true : false;
 | 
						|
		} else {
 | 
						|
			result = value;
 | 
						|
		}
 | 
						|
	}
 | 
						|
 | 
						|
	return result;
 | 
						|
}
 | 
						|
 | 
						|
export function getModuleName(path: string): string {
 | 
						|
	const moduleName = path.replace('./', '');
 | 
						|
 | 
						|
	return sanitizeModuleName(moduleName);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * Helps sanitize a module name if it is prefixed with '~/', '~' or '/'
 | 
						|
 * @param moduleName the name
 | 
						|
 * @param removeExtension whether to remove extension
 | 
						|
 */
 | 
						|
export function sanitizeModuleName(moduleName: string, removeExtension = true): string {
 | 
						|
	moduleName = moduleName.trim();
 | 
						|
 | 
						|
	if (moduleName.startsWith('~/')) {
 | 
						|
		moduleName = moduleName.substring(2);
 | 
						|
	} else if (moduleName.startsWith('~')) {
 | 
						|
		moduleName = moduleName.substring(1);
 | 
						|
	} else if (moduleName.startsWith('/')) {
 | 
						|
		moduleName = moduleName.substring(1);
 | 
						|
	}
 | 
						|
 | 
						|
	if (removeExtension) {
 | 
						|
		const extToRemove = ['js', 'ts', 'xml', 'html', 'css', 'scss'];
 | 
						|
		const extensionRegEx = new RegExp(`(.*)\\.(?:${extToRemove.join('|')})`, 'i');
 | 
						|
		moduleName = moduleName.replace(extensionRegEx, '$1');
 | 
						|
	}
 | 
						|
 | 
						|
	return moduleName;
 | 
						|
}
 | 
						|
 | 
						|
export function isFileOrResourcePath(path: string): boolean {
 | 
						|
	if (!types.isString(path)) {
 | 
						|
		return false;
 | 
						|
	}
 | 
						|
 | 
						|
	return (
 | 
						|
		path.indexOf('~/') === 0 || // relative to AppRoot
 | 
						|
		path.indexOf('/') === 0 || // absolute path
 | 
						|
		path.indexOf(RESOURCE_PREFIX) === 0
 | 
						|
	); // resource
 | 
						|
}
 | 
						|
 | 
						|
export function isFontIconURI(uri: string): boolean {
 | 
						|
	if (!types.isString(uri)) {
 | 
						|
		return false;
 | 
						|
	}
 | 
						|
 | 
						|
	const firstSegment = uri.trim().split('//')[0];
 | 
						|
 | 
						|
	return firstSegment && firstSegment.indexOf('font:') === 0;
 | 
						|
}
 | 
						|
 | 
						|
export function isDataURI(uri: string): boolean {
 | 
						|
	if (!types.isString(uri)) {
 | 
						|
		return false;
 | 
						|
	}
 | 
						|
 | 
						|
	const firstSegment = uri.trim().split(',')[0];
 | 
						|
 | 
						|
	return firstSegment && firstSegment.indexOf('data:') === 0 && firstSegment.indexOf('base64') >= 0;
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * Get file extension from file path
 | 
						|
 * @param path file path
 | 
						|
 * @returns file extension
 | 
						|
 */
 | 
						|
export function getFileExtension(path: string): string {
 | 
						|
	const dotIndex = path.lastIndexOf('.');
 | 
						|
	if (dotIndex && dotIndex >= 0 && dotIndex < path.length) {
 | 
						|
		return path.substring(dotIndex);
 | 
						|
	}
 | 
						|
 | 
						|
	return '';
 | 
						|
}
 | 
						|
 | 
						|
export function mergeSort(arr, compareFunc) {
 | 
						|
	if (arr.length < 2) {
 | 
						|
		return arr;
 | 
						|
	}
 | 
						|
 | 
						|
	const middle = arr.length / 2;
 | 
						|
	const left = arr.slice(0, middle);
 | 
						|
	const right = arr.slice(middle, arr.length);
 | 
						|
 | 
						|
	return merge(mergeSort(left, compareFunc), mergeSort(right, compareFunc), compareFunc);
 | 
						|
}
 | 
						|
 | 
						|
export function merge(left, right, compareFunc) {
 | 
						|
	const result = [];
 | 
						|
	while (left.length && right.length) {
 | 
						|
		if (compareFunc(left[0], right[0]) <= 0) {
 | 
						|
			result.push(left.shift());
 | 
						|
		} else {
 | 
						|
			result.push(right.shift());
 | 
						|
		}
 | 
						|
	}
 | 
						|
 | 
						|
	while (left.length) {
 | 
						|
		result.push(left.shift());
 | 
						|
	}
 | 
						|
 | 
						|
	while (right.length) {
 | 
						|
		result.push(right.shift());
 | 
						|
	}
 | 
						|
 | 
						|
	return result;
 | 
						|
}
 | 
						|
 | 
						|
export function hasDuplicates(arr: Array<any>): boolean {
 | 
						|
	return arr.length !== eliminateDuplicates(arr).length;
 | 
						|
}
 | 
						|
 | 
						|
export function eliminateDuplicates(arr: Array<any>): Array<any> {
 | 
						|
	return Array.from(new Set(arr));
 | 
						|
}
 | 
						|
 | 
						|
export function executeOnMainThread(func: Function) {
 | 
						|
	if (isMainThread()) {
 | 
						|
		return func();
 | 
						|
	} else {
 | 
						|
		dispatchToMainThread(func);
 | 
						|
	}
 | 
						|
}
 | 
						|
 | 
						|
export function executeOnUIThread(func: Function) {
 | 
						|
	dispatchToUIThread(func);
 | 
						|
}
 | 
						|
 | 
						|
export function mainThreadify(func: Function): (...args: any[]) => void {
 | 
						|
	return function (...args) {
 | 
						|
		const argsToPass = args;
 | 
						|
		executeOnMainThread(() => func.apply(this, argsToPass));
 | 
						|
	};
 | 
						|
}
 | 
						|
 | 
						|
export function debounce(fn: any, delay = 300) {
 | 
						|
	let timer: NodeJS.Timeout;
 | 
						|
	return (...args: Array<any>) => {
 | 
						|
		clearTimeout(timer);
 | 
						|
		timer = setTimeout(() => {
 | 
						|
			fn.apply(this, args);
 | 
						|
		}, delay);
 | 
						|
	};
 | 
						|
}
 | 
						|
 | 
						|
export function throttle(fn: Function, delay = 300) {
 | 
						|
	let waiting = false;
 | 
						|
	return function (...args) {
 | 
						|
		if (!waiting) {
 | 
						|
			fn.apply(this, args);
 | 
						|
			waiting = true;
 | 
						|
			setTimeout(function () {
 | 
						|
				waiting = false;
 | 
						|
			}, delay);
 | 
						|
		}
 | 
						|
	};
 | 
						|
}
 | 
						|
 | 
						|
let throttledGC: Map<number, () => void>;
 | 
						|
let debouncedGC: Map<number, () => void>;
 | 
						|
 | 
						|
export function queueGC(delay = 900, useThrottle?: boolean) {
 | 
						|
	/**
 | 
						|
	 * developers can use different queueGC settings to optimize their own apps
 | 
						|
	 * each setting is stored in a Map to reuse each time app calls it
 | 
						|
	 */
 | 
						|
	if (useThrottle) {
 | 
						|
		if (!throttledGC) {
 | 
						|
			throttledGC = new Map();
 | 
						|
		}
 | 
						|
		if (!throttledGC.get(delay)) {
 | 
						|
			throttledGC.set(
 | 
						|
				delay,
 | 
						|
				throttle(() => GC(), delay)
 | 
						|
			);
 | 
						|
		}
 | 
						|
		throttledGC.get(delay)();
 | 
						|
	} else {
 | 
						|
		if (!debouncedGC) {
 | 
						|
			debouncedGC = new Map();
 | 
						|
		}
 | 
						|
		if (!debouncedGC.get(delay)) {
 | 
						|
			debouncedGC.set(
 | 
						|
				delay,
 | 
						|
				debounce(() => GC(), delay)
 | 
						|
			);
 | 
						|
		}
 | 
						|
		debouncedGC.get(delay)();
 | 
						|
	}
 | 
						|
}
 | 
						|
 | 
						|
export function isEmoji(value: string): boolean {
 | 
						|
	// TODO: In a future runtime update, we can switch to using Unicode Property Escapes:
 | 
						|
	// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions/Unicode_Property_Escapes
 | 
						|
	return emojiRegex().test(value);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * Default animation values used throughout core
 | 
						|
 */
 | 
						|
export const CORE_ANIMATION_DEFAULTS = {
 | 
						|
	duration: 0.35,
 | 
						|
	spring: {
 | 
						|
		tension: 140,
 | 
						|
		friction: 10,
 | 
						|
		mass: 1,
 | 
						|
		velocity: 0,
 | 
						|
	},
 | 
						|
};
 | 
						|
 | 
						|
/**
 | 
						|
 * Get a duration with damping value from various spring related settings.
 | 
						|
 * Helpful when needing to convert spring settings to isolated duration value.
 | 
						|
 * @param springSettings various spring settings
 | 
						|
 * @returns calculated duration with damping from spring settings
 | 
						|
 */
 | 
						|
export function getDurationWithDampingFromSpring(springSettings?: { tension?: number; friction?: number; mass?: number; velocity?: number }) {
 | 
						|
	// for convenience, default spring settings are provided
 | 
						|
	const opt = {
 | 
						|
		...CORE_ANIMATION_DEFAULTS.spring,
 | 
						|
		...(springSettings || {}),
 | 
						|
	};
 | 
						|
	const damping = opt.friction / Math.sqrt(2 * opt.tension);
 | 
						|
	const undampedFrequency = Math.sqrt(opt.tension / opt.mass);
 | 
						|
 | 
						|
	// console.log({
 | 
						|
	// 	damping,
 | 
						|
	// 	undampedFrequency
 | 
						|
	// })
 | 
						|
 | 
						|
	const epsilon = 0.001;
 | 
						|
	let duration = 0;
 | 
						|
 | 
						|
	if (damping < 1) {
 | 
						|
		// console.log('damping < 1');
 | 
						|
		const a = Math.sqrt(1 - Math.pow(damping, 2));
 | 
						|
		const b = opt.velocity / (a * undampedFrequency);
 | 
						|
		const c = damping / a;
 | 
						|
		const d = -((b - c) / epsilon);
 | 
						|
		if (d > 0) {
 | 
						|
			duration = Math.log(d) / (damping * undampedFrequency);
 | 
						|
		}
 | 
						|
	}
 | 
						|
	return {
 | 
						|
		duration,
 | 
						|
		damping,
 | 
						|
	};
 | 
						|
}
 |