@neovici/cosmoz-utils 4.0.0-beta.2 → 5.1.0

package/lib/hooks/use-debounce-raf.js

@@ -1,49 +0,0 @@
-import {
-	useState,
-	useEffect
-} from 'haunted';
-
-/**
- * Debounces a value by updating it via a double requestAnimationFrame call.
- *
- * Double RAF is useful for ensuring that animations start before expensive rendering is done.
- * It helps provide smoother user experience by making animations feel reactive.
- * Normal rendering would block the animation from starting.
- *
- * In the context of haunted, the double RAF call makes sure the value is updated *after* all
- * hooks have been processed and the rendering has been done. Effectively all rapid, intermediary
- * state changes will be skipped.
- *
- * @template T
- * @param {T} value the value to debounce
- * @returns {T} the debounced value
- */
-export const useDebounceRaf = value => {
-	// State and setters for debounced value
-	const [debouncedValue, setDebouncedValue] = useState(value);
-
-	useEffect(
-		() => {
-			/**
-			 * @type {?number}
-			 */
-			let double;
-
-			// Update debounced value after double RAF
-			const handler = requestAnimationFrame(() => {
-				double = requestAnimationFrame(() => setDebouncedValue(value));
-			});
-
-			// Cancel the animation frames if value changes (also on unmount)
-			// This is how we prevent debounced value from updating if value is changed.
-			// RAF gets cleared and restarted.
-			return () => {
-				cancelAnimationFrame(handler);
-				cancelAnimationFrame(double);
-			};
-		},
-		[value] // Only re-call effect if value changes
-	);
-
-	return debouncedValue;
-};

package/lib/hooks/use-dropped-files.js

@@ -1,12 +0,0 @@
-import {
-	useState,
-	useCallback
-} from 'haunted';
-import { useHandleDrop } from './use-handle-drop';
-
-export const useDroppedFiles = el => {
-	const [files, setFiles] = useState([]),
-		handleDrop = useCallback(event => setFiles(event.dataTransfer.files), [setFiles]);
-	useHandleDrop(el, handleDrop);
-	return files;
-};

package/lib/hooks/use-handle-drop.js

@@ -1,22 +0,0 @@
-import { useEffect } from 'haunted';
-
-export const useHandleDrop = (el, callback) =>
-	useEffect(() => {
-		const dragStop = event => {
-				event.stopPropagation();
-				event.preventDefault();
-			},
-			handleDrop = event => {
-				dragStop(event);
-				callback(event);
-			};
-
-		el.addEventListener('dragenter', dragStop);
-		el.addEventListener('dragover', dragStop);
-		el.addEventListener('drop', handleDrop);
-		return () => {
-			el.removeEventListener('dragenter', dragStop);
-			el.removeEventListener('dragover', dragStop);
-			el.removeEventListener('drop', handleDrop);
-		};
-	}, [el, callback]);

package/lib/hooks/use-host-bounds.js

@@ -1,21 +0,0 @@
-import {
-	useLayoutEffect,
-	useState
-} from 'haunted';
-
-import { useHost } from './use-host';
-
-const useHostBounds = () => {
-	const host = useHost(),
-		[bounds, setBounds] = useState();
-
-	useLayoutEffect(() => {
-		const observer = new ResizeObserver(entries => requestAnimationFrame(() => setBounds(entries[0]?.contentRect)));
-		observer.observe(host);
-		return () => observer.unobserve(host);
-	}, []);
-
-	return bounds;
-};
-
-export { useHostBounds };

package/lib/hooks/use-host.js

@@ -1,9 +0,0 @@
-import {
-	hook, Hook
-} from 'haunted';
-
-export const useHost = hook(class extends Hook {
-	update() {
-		return this.state.host;
-	}
-});

package/lib/hooks/use-imperative-api.js

@@ -1,22 +0,0 @@
-import {
-	Hook, hook
-} from 'haunted';
-
-export const useImperativeApi = hook(class extends Hook {
-	constructor(id, state, api, values) {
-		super(id, state);
-		Object.assign(state.host, api);
-		this.values = values;
-	}
-
-	update(api, values) {
-		if (this.hasChanged(values)) {
-			this.values = values;
-			Object.assign(this.state.host, api);
-		}
-	}
-
-	hasChanged(values = []) {
-		return values.some((value, i) => this.values[i] !== value);
-	}
-});

package/lib/hooks/use-notify-property.js

@@ -1,26 +0,0 @@
-import { useEffect } from 'haunted';
-import { useHost } from './use-host';
-
-const UPPER = /([A-Z])/gu,
-
-	/* Emulate polymer notify props */
-	notifyProperty = (host, name, value) => {
-		// this is required to make polymer double-binding recognize the change
-		// @see https://github.com/Polymer/polymer/blob/76c71e186ecc605294c3575dd31ac7983a8b3ae3/lib/mixins/property-effects.js#L382
-		host[name] = value;
-
-		// emulate polymer notify event
-		host.dispatchEvent(new CustomEvent(name.replace(UPPER, '-$1').toLowerCase() + '-changed', { detail: { value }}));
-	},
-
-	useNotifyProperty = (name, value) => {
-		const host = useHost();
-		useEffect(() => {
-			notifyProperty(host, name, value);
-		}, [value]);
-	};
-
-export {
-	notifyProperty,
-	useNotifyProperty
-};

package/lib/hooks/use-promise.js

@@ -1,74 +0,0 @@
-import {
-	useReducer,
-	useEffect
-} from 'haunted';
-import {
-	reduce,
-	action
-} from '../reduce';
-
-const
-	states = {
-		pending: 'pending',
-		rejected: 'rejected',
-		resolved: 'resolved'
-	},
-	initial = {
-		error: undefined,
-		result: undefined,
-		state: states.pending
-	},
-	pending = action(states.pending),
-	resolved = action(states.resolved, result => ({ result })),
-	rejected = action(states.rejected, error => ({ error })),
-	reducer = reduce(initial, [
-		[pending, () => ({
-			error: undefined,
-			result: undefined,
-			state: states.pending
-		})],
-
-		[resolved, (state, { result }) => ({
-			error: undefined,
-			result,
-			state: states.resolved
-		})],
-
-		[rejected, (state, { error }) => ({
-			error,
-			result: undefined,
-			state: states.rejected
-		})]
-	]);
-
-export const usePromise = promise => {
-	const [
-		{
-			error,
-			result,
-			state
-		},
-		dispatch
-	] = useReducer(reducer, initial);
-
-	useEffect(() => {
-		if (!promise) {
-			return;
-		}
-
-		let canceled = false;
-
-		dispatch(pending());
-
-		promise.then(
-			result => !canceled && dispatch(resolved(result)),
-			error => !canceled && dispatch(rejected(error))
-		);
-
-		return () => {
-			canceled = true;
-		};
-	}, [promise]);
-
-	return [result, error, state];
-};

package/lib/money.js

@@ -1,105 +0,0 @@
-const CURRENCY_FORMATTERS = {},
-	NUMBER_FORMATTERS = {},
-	_getCurrencyFormatter = function (currency, locale, currencyDisplay = 'code') {
-		if (currency == null) {
-			return;
-		}
-		const key = currency.toUpperCase() + (locale || '');
-		if (CURRENCY_FORMATTERS[key] == null) {
-			CURRENCY_FORMATTERS[key] = new Intl.NumberFormat(locale, {
-				style: 'currency',
-				currency,
-				currencyDisplay
-			});
-		}
-		return CURRENCY_FORMATTERS[key];
-	},
-	/**
-	 * Determine if a constant or a variable is an amount.
-	 * @param {object} potentialAmount Potential amount.
-	 * @returns {boolean} Whether the potential amount is a valid amount object with amount and currency.
-	 */
-	isAmount = function (potentialAmount) {
-		return (
-			potentialAmount != null &&
-			potentialAmount.amount != null &&
-			potentialAmount.currency != null &&
-			typeof potentialAmount.amount === 'number' &&
-			typeof potentialAmount.currency === 'string' &&
-			potentialAmount.currency.length === 3
-		);
-	},
-	/**
-	 * Render an amount with decimal separator and currency symbol.
-	 * @param	 {object} money Money with amount property and optionally currency property.
-	 * @param	{void|string} locale Locale to format the amount in.
-	 * @return {string} Formatted amount.
-	 */
-	renderAmount = function (money, locale) {
-		if (money?.amount == null) {
-			return;
-		}
-		const formatter = _getCurrencyFormatter(money.currency, locale);
-		if (formatter == null) {
-			return;
-		}
-		return formatter.format(money.amount);
-	},
-	/**
-	 * Alias for renderAmount(money). Render an amount with decimal separator and currency symbol.
-	 * @param	 {object} money Money with amount property and optionally currency property.
-	 * @return {string} Formatted amount.
-	 */
-	renderMoney = renderAmount,
-	/**
-	 * Render an amount with decimal separator but without currency symbol.
-	 * @param	 {object} money Money with amount property and optionally currency property.
-	 * @param	{void|string} locale Locale to format the amount in.
-	 * @return {string} Formatted number.
-	 */
-	renderNumberAmount = function (money, locale) {
-		const key = locale || '0';
-		if (NUMBER_FORMATTERS[key] == null) {
-			NUMBER_FORMATTERS[key] = new Intl.NumberFormat(locale, {
-				minimumFractionDigits: 2,
-				maximumFractionDigits: 2
-			});
-		}
-		return NUMBER_FORMATTERS[key].format(money.amount);
-	},
-	/**
-	 * Round a number to a given precision.
-	 * @param	 {string} number Number with decimals to round.
-	 * @param	 {number} precision Number of decimals to round amount to.
-	 * @return {number} Rounded number.
-	 */
-	round = function (number, precision) {
-		const fixed = Number(
-			Math.round(number + 'e' + precision) + 'e-' + precision
-		).toFixed(precision);
-		return parseFloat(fixed);
-	},
-	/**
-	 * Compare amounts.
-	 * @param {object} amount1 Amount 1.
-	 * @param {object} amount2 Amount 2.
-	 * @param {number} precision Decimal precision, defaults to 2 decimals.
-	 * @returns {boolean} Whether the amounts are equal regarding amount to the specified precision and the currency.
-	 */
-	amountEquals = function (amount1, amount2, precision = 2) {
-		return (
-			isAmount(amount1) &&
-			isAmount(amount2) &&
-			round(amount1.amount, precision) === round(amount2.amount, precision) &&
-			amount1.currency === amount2.currency
-		);
-	};
-
-export {
-	isAmount,
-	renderAmount,
-	renderMoney,
-	renderNumberAmount,
-	round,
-	amountEquals
-};

package/lib/object.js

@@ -1,26 +0,0 @@
-import { identity } from './function';
-
-export const prop = key => key && (object => object[key]) || identity,
-	strProp = key => {
-		const p = prop(key);
-		return o => typeof o === 'string' ? o : p(o)?.toString() || '';
-	},
-	isObject = obj => Object.prototype.toString.call(obj) === '[object Object]',
-	merge = (...objs) => objs.reduce((acc, obj) => {
-		if (obj == null) {
-			return acc;
-		}
-		for (const key of Object.keys(obj)) {
-			if (isObject(obj[key]) && isObject(acc[key])) {
-				Object.assign(acc[key], merge(acc[key], obj[key]));
-			} else if (Array.isArray(acc[key]) && Array.isArray(obj[key])) {
-				acc[key] = acc[key].concat(obj[key]);
-			} else {
-				acc[key] = obj[key];
-			}
-		}
-		return acc;
-	}, {}),
-	transform = predicate => obj => Object.fromEntries(predicate(Object.entries(obj))),
-	props = keys => transform(e => e.filter(([k]) => keys.includes(k))),
-	omit = keys => transform(e => e.filter(([k]) => !keys.includes(k)));

package/lib/promise.js

@@ -1,88 +0,0 @@
-class ManagedPromise extends Promise {
-	constructor(callback) {
-		const handles = {};
-		super((resolve, reject) => Object.assign(handles, { resolve, reject }));
-		Object.assign(this, handles);
-		callback?.(handles.resolve, handles.reject);
-	}
-}
-
-
-const timeout$ = ms => new Promise(res => setTimeout(res, ms)),
-	event$ = (target, type, predicate = () => true, timeout = 300000) =>
-		new Promise((resolve, reject) => {
-			let handler;
-			const tid = setTimeout(() => {
-				target.removeEventListener(type, handler);
-				reject(new Error('Timeout out'));
-			}, timeout);
-			target.addEventListener(
-				type,
-				handler = e => {
-					if (predicate(e)) {
-						target.removeEventListener(type, handler);
-						clearTimeout(tid);
-						resolve(e);
-					}
-				}
-			);
-		}),
-	limit$ = (fn, limit) => {
-		const state = {
-				queue: [],
-				pending: []
-			},
-			process = () => {
-				if (state.queue.length === 0) {
-					return;
-				}
-
-				if (state.pending.length >= limit) {
-					return;
-				}
-
-				const task = state.queue.shift();
-				state.pending.push(task);
-				Promise.resolve(fn(...task.args))
-					.then(task.resolve, task.reject)
-					.then(() => {
-						state.pending.splice(state.pending.indexOf(task), 1);
-						process();
-					});
-			};
-
-		return (...args) =>
-			new Promise((resolve, reject) => {
-				state.queue.push({ args, resolve, reject });
-				process();
-			});
-	},
-	debounce$ = (fn, ms) => {
-		let timeoutId;
-		const pending = [];
-		return (...args) =>
-			new Promise((res, rej) => {
-				clearTimeout(timeoutId);
-				timeoutId = setTimeout(() => {
-					const currentPending = [...pending];
-					pending.length = 0;
-					Promise.resolve(fn(...args)).then(
-						data => {
-							currentPending.forEach(({ resolve }) => resolve(data));
-						},
-						error => {
-							currentPending.forEach(({ reject }) => reject(error));
-						}
-					);
-				}, ms);
-				pending.push({ resolve: res, reject: rej });
-			});
-	};
-
-export {
-	ManagedPromise,
-	timeout$,
-	event$,
-	limit$,
-	debounce$
-};

package/lib/reduce/action.js

@@ -1,16 +0,0 @@
-const action = (type, create = () => ({})) => {
-		const common = {
-				type,
-				toString() {
-					return type;
-				}
-			},
-			callable = (...args) => Object.assign(create(...args), common);
-		return Object.assign(callable, common);
-	},
-	type = action => action.type || action.toString();
-
-
-export {
-	action, type
-};

package/lib/reduce/reduce.js

@@ -1,16 +0,0 @@
-import { type } from './action';
-
-const ensureArray = x => Array.isArray(x) ? x : [x],
-	reduce = (initial, handle) => {
-		const handles = ensureArray(handle),
-			handlers = (handles.every(Array.isArray) ? handles : [handles]).map(([actions, handle]) => ({
-				actions: ensureArray(actions).map(type),
-				handle
-			}));
-		return (state = initial, action) => {
-			const handler = handlers.find(h => h.actions.includes(type(action)));
-			return handler ? handler.handle(state, action) : state;
-		};
-	};
-
-export { reduce };

package/lib/tag.js

@@ -1,34 +0,0 @@
-import { html as htm } from 'haunted';
-
-const html = (arr, ...thru) =>
-	htm(
-		Object.assign(arr, { raw: true }),
-		...thru
-	);
-
-export const
-	/**
-	 * Dynamic component support for lit-html.
-	 *
-	 * Normally lit-html does not support interpolating the component tag, but we can trick it
-	 * by calling the template function manually.
-	 *
-	 * NOTE: You can only use this function for interpolating a single tag and it must be the
-	 * first interpolated value. If you need multiple components, you can do multiple interpolations.
-	 *
-	 * @example
-	 *  tag`<${name} some=${param}/>`
-	 *
-	 * @example
-	 * 	html`A: ${ tag`<${ aTag }/>` } - B: ${ tag`${ bTag }` }`
-	 *
-	 * @param   {string[]}     strings    The static strings.
-	 * @param   {string}       component  The interpolated component name.
-	 * @param   {any[]}        values     The interpolated values.
-	 *
-	 * @return  {TemplateResult}          The lit template result.
-	 */
-	tag = (strings, component, ...values) => html([
-		strings[0] + component + strings[1],
-		...strings.slice(2)
-	], ...values);

package/lib/template.js

@@ -1,89 +0,0 @@
-const abs = Math.abs,
-	/**
-	 * Check if any of the arguments are true.
-	 * @return {Boolean} Whether any of the function arguments are true or not.
-	 */
-	anyTrue = function () {
-		const argumentArray = Array.prototype.slice.call(arguments);
-		return argumentArray.some(arg => !!arg);
-	},
-	/**
-	 * Concatenate all arguments to a string.
-	 * @return {string} Concatenated arguments.
-	 */
-	concat = function () {
-		return Array.prototype.join.call(arguments, '');
-	},
-	/**
-	 * If iftrue argument is true, return result argument, otherwise return elseresult argument.
-	 * @param {boolean} iftrue Codition for result
-	 * @param {*} result Result when iftrue is true.
-	 * @param {*} elseresult Result when iftrue is false.
-	 * @return {boolean} result or elseresult depending on iftrue evaluation.
-	 */
-	ifElse = function (iftrue, result, elseresult) {
-		return iftrue ? result : elseresult;
-	},
-	/**
-	 * Check if item argument exists in array argument.
-	 * @param {*} item Item to search for in the array.
-	 * @param {array} array Array to search.
-	 * @return {boolean} Whether the item was found in array or not.
-	 */
-	inArray = function (item, array) {
-		return array.indexOf(item) > -1;
-	},
-	/**
-	 * Check equality of the arguments.
-	 * @param {*} arg1 First argument to compare.
-	 * @param {*} arg2 Second argument to compare
-	 * @return {boolean} Whether the first and second arguments are equal or not.
-	 */
-	isEqual = function (arg1, arg2) {
-		return arg1 === arg2;
-	},
-	/**
-	 * Check if argument is undefined, null, empty Array list,
-	 * empty String or 0 number (like length).
-	 * @param	 {object}	 obj Argument to evaluate.
-	 * @return {boolean}	Whether the argument is empty or not.
-	 */
-	isEmpty = function (obj) {
-		if (obj === undefined || obj === null) {
-			return true;
-		}
-		if (obj instanceof Array && obj.length === 0) {
-			return true;
-		}
-		const objType = typeof obj;
-		if (objType === 'string' && obj.length === 0) {
-			return true;
-		}
-		if (objType === 'number' && obj === 0) {
-			return true;
-		}
-		return false;
-	},
-	/**
-	 * Formats a number using fixed-point notation.
-	 * @param {number} number Number with decimals to be formatted.
-	 * @param {number} fixval Number of decimals to use.
-	 * @return {String} The number converted to string keep only fixval number of decimals, if number empty, returns empty string
-	 */
-	toFixed = function (number, fixval) {
-		if (typeof number !== 'number') {
-			return '';
-		}
-		return number.toFixed(fixval);
-	};
-
-export {
-	abs,
-	anyTrue,
-	concat,
-	ifElse,
-	inArray,
-	isEqual,
-	isEmpty,
-	toFixed
-};