vivth 0.9.4 → 0.11.0

package/src/function/NewPingFIFO.mjs

@@ -1,91 +0,0 @@
-// @ts-check
-
-import { timeout } from '../common.mjs';
-
-/**
- * @description
- * - function to auto queue callbacks that will be called `first in first out` style;
- * ```js
- * // @ts-check
- * import { NewPingFIFO } from 'vivth';
- * const debounceMS = 0; // in miliseconds, optionals, default is 0;
- * const handler = () =>{
- * 	NewPingFIFO(async () => {
- * 		// your code
- * 	}, debounceMS);
- * }
- * ```
- */
-class qFIFO {
-	static {
-		new qFIFO();
-	}
-	/**
-	 * @typedef {[callback:()=>(any|Promise<any>),debounce?:(number)]} queueFIFODetails
-	 */
-	/**
-	 * @private
-	 */
-	constructor() {}
-	/**
-	 * queue
-	 * @private
-	 * @type {queueFIFODetails[]}
-	 */
-	static q = [];
-	/**
-	 * isRunning
-	 * @private
-	 * @type {boolean}
-	 */
-	static R = false;
-	/**
-	 * auto initiator
-	 * @private
-	 */
-	/**
-	 * assign
-	 * @type {(...queueFIFODetails:queueFIFODetails)=>void}
-	 */
-	static a = (..._queue) => {
-		qFIFO.p(_queue);
-		if (!qFIFO.R) {
-			qFIFO.r();
-		}
-	};
-	/**
-	 * push
-	 * @private
-	 * @param {queueFIFODetails} _queue
-	 */
-	static p = (_queue) => {
-		qFIFO.q.push(_queue);
-	};
-	/**
-	 * run
-	 * @private
-	 */
-	static r = async () => {
-		qFIFO.R = true;
-		while (qFIFO.q.length !== 0) {
-			const [callback, debounceMs = 0] = qFIFO.q[0];
-			qFIFO.q.shift();
-			await callback();
-			/**
-			 * conditional debounce;
-			 * queue FIFO messing up when have debouncer while `debounceMS` are set to 0;
-			 */
-			// if (debounceMs) {
-			await timeout(debounceMs);
-			// }
-		}
-		qFIFO.R = false;
-	};
-}
-
-/**
- * @param {()=>(any|Promise<any>)} callback
- * @param {number} debounce
- * @returns
- */
-export const NewPingFIFO = (callback, debounce = 0) => qFIFO.a(callback, debounce);

package/src/function/NewPingUnique.mjs

@@ -1,92 +0,0 @@
-// @ts-check
-
-import { timeout } from '../common.mjs';
-
-/**
- * @description
- * - function to auto queue callbacks:
- * > - different `uniqueID`: called `first in first out` style;
- * > - same `uniqueID`: will be grouped, only the already running callback and the last callback will be called;
- * ```js
- * // @ts-check
- * import { NewPingUnique } from 'vivth';
- * const uniqueID = 'yourUniqueID'; // can be anything, even a reference to an object;
- * const debounceMS = 0; // in miliseconds, optionals, default is 0;
- * const handler = () =>{
- * 	NewPingUnique(uniqueID, async () => {
- * 		// your code
- * 	}, debounceMS);
- * }
- * ```
- */
-class qUnique {
-	/**
-	 * @typedef {import('../types/anyButUndefined.type.mjs').anyButUndefined} anyButUndefined
-	 * @typedef {Object} queueUniqueObject
-	 * @property {any} i
-	 * @property {()=>(any|Promise<any>)} c
-	 * @property {number} [d]
-	 */
-	/**
-	 * @private
-	 * @type {Map<any, [()=>Promise<any>,number]>}
-	 */
-	static queue = new Map();
-	/**
-	 * isRunning
-	 * @private
-	 * @type {boolean}
-	 */
-	static r = false;
-	/**
-	 * assign
-	 * @type {(queueUniqueObject:queueUniqueObject)=>void}
-	 */
-	static A = (_queue) => {
-		qUnique.p(_queue);
-		if (!qUnique.r) {
-			qUnique.R();
-		}
-	};
-	/**
-	 * push
-	 * @private
-	 * @param {queueUniqueObject} _queue
-	 */
-	static p = (_queue) => {
-		const { i, c, d } = _queue;
-		qUnique.queue.set(i, [c, d ? d : 0]);
-	};
-	/**
-	 * run
-	 * @private
-	 */
-	static R = async () => {
-		qUnique.r = true;
-		const keysIterator = qUnique.queue.keys();
-		let keys = keysIterator.next();
-		while (!keys.done) {
-			const key = keys.value;
-			const [callback, debounce] = qUnique.queue.get(key);
-			qUnique.queue.delete(key);
-			/**
-			 * debounce anyway;
-			 * queue with unique id have characteristic of messing up when have no debouncer;
-			 * especially when request comes too fast;
-			 */
-			await timeout(debounce);
-			await callback();
-			keys = keysIterator.next();
-		}
-		qUnique.r = false;
-	};
-}
-
-/**
- * @param {anyButUndefined} uniqueID
- * @param {()=>(any|Promise<any>)} callback
- * @param {number} debounce
- * @returns
- */
-export const NewPingUnique = (uniqueID, callback, debounce = 0) =>
-	qUnique.A({ i: uniqueID, c: callback, d: debounce });

package/src/function/NewSignal.mjs

@@ -1,28 +0,0 @@
-// @ts-check
-
-import { Signal } from '../class/Signal.mjs';
-
-/**
- * @description
- *  - function to create `signal`;
- *  - syntatic sugar for [Signal](#signal);
- * ```js
- * import { New$, NewDerived, NewSignal } from 'vivth';
- * const signal = NewSignal(0);
- * const derived = NewDerived(async () =>{
- *  // runs everytime signal.value changes;
- *  return signal.value * 2;
- * });
- * const autosubscriber = New$(async ()=>{
- *  // runs everytime signal.value changes;
- *  console.log(signal.value);
- * });
- * signal.value = 1;
- * ```
- */
-/**
- * @template Value
- * @param {Value} value
- * @returns {Signal<Value>}
- */
-export const NewSignal = (value) => new Signal(value);

package/types/src/function/New$.d.mts

@@ -1,2 +0,0 @@
-export function New$(effect: () => void): $;
-import { $ } from '../class/$.mjs';

package/types/src/function/NewDerived.d.mts

@@ -1,2 +0,0 @@
-export function NewDerived<V>(derivedFunction: () => (V)): Derived<V>;
-import { Derived } from '../class/Derived.mjs';

package/types/src/function/NewPingFIFO.d.mts

@@ -1 +0,0 @@
-export function NewPingFIFO(callback: () => (any | Promise<any>), debounce?: number): void;

package/types/src/function/NewPingUnique.d.mts

@@ -1 +0,0 @@
-export function NewPingUnique(uniqueID: import("../types/anyButUndefined.type.mjs").anyButUndefined, callback: () => (any | Promise<any>), debounce?: number): void;

package/types/src/function/NewSignal.d.mts

@@ -1,2 +0,0 @@
-export function NewSignal<Value>(value: Value): Signal<Value>;
-import { Signal } from '../class/Signal.mjs';

package/types/src/function/trySync.export.d.mts

@@ -1 +0,0 @@
-export function trySync<ResultType>(function_: () => ResultType): [ResultType | undefined, Error | undefined];

package/types/src/types/anyButUndefined.type.d.mts

@@ -1 +0,0 @@
-export type anyButUndefined = {} | null | number | string | boolean | symbol | bigint | Function;