mirror of
https://github.com/NativeScript/NativeScript.git
synced 2025-08-14 10:01:08 +08:00
295 lines
7.1 KiB
TypeScript
295 lines
7.1 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 SYSTEM_PREFIX = 'sys://';
|
|
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 ||
|
|
path.indexOf(SYSTEM_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, { leading }: { leading?: boolean } = {}) {
|
|
let timer: NodeJS.Timeout;
|
|
return (...args: Array<any>) => {
|
|
if (timer === undefined && leading) {
|
|
fn.apply(this, args);
|
|
}
|
|
clearTimeout(timer);
|
|
timer = setTimeout(() => {
|
|
fn.apply(this, args);
|
|
timer = undefined;
|
|
}, 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,
|
|
};
|
|
}
|