@softsky/utils 2.5.3 → 2.5.5

package/README.md

@@ -10,10 +10,10 @@
 
 `npm i @softsky/utils`
 
+__ZERO DEPENDENCIES__ utils library. Test coverage __100%__.
+
 Usual utils plus more obscure stuff that I've never seen in any library. 
 Also fancy TypeScript generics and types that I often use.
-
-Test coverage __100%__.
 </div>
 
 # Contribute
@@ -363,6 +363,7 @@ const mySignal = $mySignal()
 if(last>mySignal) console.log('Increment!')
 return mySignal;
 })
+```
 
 ---
 __function__ `untrack` - __SIGNALS SYSTEM__
@@ -429,6 +430,18 @@ Timers, CRON, etc.
 
 __function__ `measurePerformance` - Measure performance of a function
 
+---
+__function__ `setSafeTimeout` - Original setTimeout and setIntval known for accumulating delay
+and causing problem with timeouts bigger than 32bit integer.
+
+This timeout wrapper fixes them. Returns clear function.
+
+---
+__function__ `setSafeInterval` - Original setTimeout and setIntval known for accumulating delay
+and causing problem with timeouts bigger than 32bit integer.
+
+This interval wrapper fixes them. Returns clear function.
+
 ---
 __function__ `cronInterval` - Like setInterval but with cron.
 Returns clear function.
@@ -499,3 +512,23 @@ __type__ `ObjectSnakeToCamel` - Convert object keys of this-case to thisCase
 __type__ `Concat` - Concat types of array or objects
 
 ---
+__type__ `Prettify` - Visual only overhaul. Shows final type result on hover.
+```ts
+type a = {a: '1'}
+type b = Prettify<a & { b: 'b' }>
+```
+On hovering b it will show
+```ts
+type b = {
+a: "1";
+b: "b";
+}
+```
+instead of
+```ts
+type b = a & {
+b: "b";
+}
+```
+
+---

package/dist/signals.d.ts

@@ -42,6 +42,7 @@ export declare function signal<T>(value: T): Signal<T>;
  *   if(last>mySignal) console.log('Increment!')
  *   return mySignal;
  * })
+ * ```
  */
 export declare function effect<T>(handler: (argument: T | undefined) => T, initialValue?: T): () => void;
 /**

package/dist/signals.js

@@ -58,6 +58,7 @@ function clearEffect(handler) {
  *   if(last>mySignal) console.log('Increment!')
  *   return mySignal;
  * })
+ * ```
  */
 export function effect(handler, initialValue) {
     let lastValue = initialValue;

package/dist/time.d.ts

@@ -1,8 +1,23 @@
 /**
  * Timers, CRON, etc.
  */
+import { AnyFunction } from './types';
 /** Measure performance of a function */
 export declare function measurePerformance(function_: () => unknown, timeCheck?: number): number;
+/**
+ * Original setTimeout and setIntval known for accumulating delay
+ * and causing problem with timeouts bigger than 32bit integer.
+ *
+ * This timeout wrapper fixes them. Returns clear function.
+ */
+export declare function setSafeTimeout(handler: AnyFunction, delay: number): () => void;
+/**
+ * Original setTimeout and setIntval known for accumulating delay
+ * and causing problem with timeouts bigger than 32bit integer.
+ *
+ * This interval wrapper fixes them. Returns clear function.
+ */
+export declare function setSafeInterval(handler: AnyFunction, delay: number): () => void;
 /** Like setInterval but with cron.
  *  Returns clear function.
  *  For cron string syntax check __getNextCron()__ description */

package/dist/time.js

@@ -13,6 +13,51 @@ export function measurePerformance(function_, timeCheck = 16.6) {
     }
     return executions;
 }
+/**
+ * Original setTimeout and setIntval known for accumulating delay
+ * and causing problem with timeouts bigger than 32bit integer.
+ *
+ * This timeout wrapper fixes them. Returns clear function.
+ */
+export function setSafeTimeout(handler, delay) {
+    const end = Date.now() + delay;
+    let timeout;
+    function r() {
+        const timeLeft = end - Date.now();
+        if (timeLeft < 1)
+            handler();
+        else
+            timeout = setTimeout(r, Math.min(timeLeft, HOUR_MS));
+    }
+    r();
+    return () => {
+        clearTimeout(timeout);
+    };
+}
+/**
+ * Original setTimeout and setIntval known for accumulating delay
+ * and causing problem with timeouts bigger than 32bit integer.
+ *
+ * This interval wrapper fixes them. Returns clear function.
+ */
+export function setSafeInterval(handler, delay) {
+    let end = Date.now() + delay;
+    let timeout;
+    function r() {
+        const timeLeft = end - Date.now();
+        if (timeLeft < 1) {
+            end += delay;
+            handler();
+            r();
+        }
+        else
+            timeout = setTimeout(r, Math.min(timeLeft, HOUR_MS));
+    }
+    r();
+    return () => {
+        clearInterval(timeout);
+    };
+}
 /** Like setInterval but with cron.
  *  Returns clear function.
  *  For cron string syntax check __getNextCron()__ description */

package/dist/types.d.ts

@@ -39,3 +39,26 @@ export type ObjectSnakeToCamel<T> = {
 };
 /** Concat types of array or objects */
 export type Concat<T, U> = T extends any[] ? U extends any[] ? [...T, ...U] : never : T & U;
+/**
+ * Visual only overhaul. Shows final type result on hover.
+ * ```ts
+ * type a = {a: '1'}
+ * type b = Prettify<a & { b: 'b' }>
+ * ```
+ * On hovering b it will show
+ * ```ts
+ * type b = {
+ *   a: "1";
+ *   b: "b";
+ * }
+ * ```
+ * instead of
+ * ```ts
+ * type b = a & {
+ *   b: "b";
+ * }
+ * ```
+ * */
+export type Prettify<T extends object> = {
+    [k in keyof T]: T[k];
+} & {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softsky/utils",
-  "version": "2.5.3",
+  "version": "2.5.5",
   "description": "JavaScript/TypeScript utilities",
   "main": "dist/index.js",
   "scripts": {
@@ -21,7 +21,7 @@
   "homepage": "https://github.com/SoundOfTheSky/utils#readme",
   "devDependencies": {
     "@softsky/configs": "^1.3.3",
-    "@types/bun": "^1.2.11"
+    "@types/bun": "^1.2.16"
   },
   "files": ["dist/**/*"]
 }