@giveback007/util-lib 2.1.2 → 2.2.0

package/dist/@state.types.d.ts

@@ -0,0 +1,16 @@
+export type Immutable<T> = {
+    readonly [K in keyof T]: Immutable<T[K]>;
+};
+export type Action<T extends string, D = undefined> = Readonly<D extends undefined ? {
+    type: T;
+} : {
+    type: T;
+    data: D;
+}>;
+export type stateSubFct<S> = (s: S, prev: S | null) => any;
+export type actSubFct<A extends Action<any, any>, S = any> = (a: A, s: S) => any;
+export type lsOptions<P> = {
+    id: string;
+    useKeys?: P[];
+    ignoreKeys?: P[];
+};

package/dist/@state.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=@state.types.js.map

package/dist/@state.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"@state.types.js","sourceRoot":"","sources":["../src/@state.types.ts"],"names":[],"mappings":""}

package/dist/@types.d.ts

@@ -53,17 +53,16 @@ export type TimeObj = {
     ms: num;
     wDay: DayOfWeek;
 };
-export type PartialTimeObj = {
-    y: num;
-    m?: num;
-    d?: num;
-    h?: num;
-    min?: num;
-    sec?: num;
-    ms?: num;
-};
-export type TimeArr = [y: num, m?: num, d?: num, h?: num, min?: num, sec?: num, ms?: num];
-export type AnyDate = string | number | Date | TimeObj | PartialTimeObj | TimeArr;
+export type TimeArr = [
+    y: num,
+    m?: num,
+    d?: num,
+    h?: num,
+    min?: num,
+    sec?: num,
+    ms?: num
+];
+export type AnyDate = string | number | Date | TimeObj | TimeArr;
 export type Dict<T> = {
     [id: string]: T;
 };

package/dist/general.d.ts

@@ -17,8 +17,6 @@ maxTimes?: number) => {
     /** Stop the interval */
     stop: () => void;
 };
-/** A promise that waits `ms` amount of milliseconds to execute */
-export declare const wait: (ms: number) => Promise<void>;
 export declare function unsubAll(objOrArr: AnyObj | any[], unsubName?: string): void;
 /**
  * Alternative to console.log in that it will clone the obj.

package/dist/general.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.debounceById = exports.debounce = exports.randomColorHex = exports.uuid = exports.cloneLog = exports.wait = exports.interval = void 0;
+exports.debounceById = exports.debounce = exports.randomColorHex = exports.uuid = exports.cloneLog = exports.interval = void 0;
 exports.unsubAll = unsubAll;
 exports.type = type;
 exports.assertType = assertType;
@@ -41,9 +41,6 @@ maxTimes = Infinity) => {
     };
 };
 exports.interval = interval;
-/** A promise that waits `ms` amount of milliseconds to execute */
-const wait = (ms) => new Promise((res) => setTimeout(() => res(), ms));
-exports.wait = wait;
 const usubAllFunct = (x, unsubName = 'unsubscribe') => (0, _1.isType)(x, 'object')
     &&
         (0, _1.hasKey)(x, unsubName) ? x[unsubName]() : null;

package/dist/general.js.map

@@ -1 +1 @@
-{"version":3,"file":"general.js","sourceRoot":"","sources":["../src/general.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"general.js","sourceRoot":"","sources":["../src/general.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,12 +1,14 @@
 export * from './@types';
+export * from './@state.types';
 export * from './array';
 export * from './clone';
 export * from './equality';
 export * from './general';
+export * from './http';
 export * from './iterate';
 export * from './number';
 export * from './object';
+export * from './state-manager';
 export * from './string';
 export * from './test';
 export * from './time';
-export * from './http';

package/dist/index.js

@@ -15,15 +15,17 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./@types"), exports);
+__exportStar(require("./@state.types"), exports);
 __exportStar(require("./array"), exports);
 __exportStar(require("./clone"), exports);
 __exportStar(require("./equality"), exports);
 __exportStar(require("./general"), exports);
+__exportStar(require("./http"), exports);
 __exportStar(require("./iterate"), exports);
 __exportStar(require("./number"), exports);
 __exportStar(require("./object"), exports);
+__exportStar(require("./state-manager"), exports);
 __exportStar(require("./string"), exports);
 __exportStar(require("./test"), exports);
 __exportStar(require("./time"), exports);
-__exportStar(require("./http"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,0CAAwB;AACxB,0CAAwB;AACxB,6CAA2B;AAC3B,4CAA0B;AAC1B,4CAA0B;AAC1B,2CAAyB;AACzB,2CAAyB;AACzB,2CAAyB;AACzB,yCAAuB;AACvB,yCAAuB;AACvB,yCAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,iDAA8B;AAC9B,0CAAwB;AACxB,0CAAwB;AACxB,6CAA2B;AAC3B,4CAA0B;AAC1B,yCAAuB;AACvB,4CAA0B;AAC1B,2CAAyB;AACzB,2CAAyB;AACzB,kDAAgC;AAChC,2CAAyB;AACzB,yCAAuB;AACvB,yCAAuB"}

package/dist/number.d.ts

@@ -18,14 +18,7 @@ export declare const average: (nArr: number[]) => number;
  * decPlaces(1.1276, 2) //=> 1.13
  * ```
  */
-export declare const decPlace: (n: number, places: number) => number;
-/**
- * @example
- * ```js
- * numberWithCommas(1000000) //=> '1,000,000'
- * ```
- */
-export declare const numberWithCommas: (n: number | string) => string;
+export declare const numFixed: (n: number, fractionDigits: number) => number;
 /**
  * Takes a number || number[] and min & max, will generate a
  * new random number.

package/dist/number.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.numberWithCommas = exports.decPlace = exports.average = exports.rand = exports.randInt = void 0;
+exports.numFixed = exports.average = exports.rand = exports.randInt = void 0;
 exports.newNum = newNum;
 const _1 = require(".");
 /**
@@ -26,16 +26,8 @@ exports.average = average;
  * decPlaces(1.1276, 2) //=> 1.13
  * ```
  */
-const decPlace = (n, places) => parseFloat(n.toFixed(places));
-exports.decPlace = decPlace;
-/**
- * @example
- * ```js
- * numberWithCommas(1000000) //=> '1,000,000'
- * ```
- */
-const numberWithCommas = (n) => n.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');
-exports.numberWithCommas = numberWithCommas;
+const numFixed = (n, fractionDigits) => parseFloat(n.toFixed(fractionDigits));
+exports.numFixed = numFixed;
 /**
  * Takes a number || number[] and min & max, will generate a
  * new random number.

package/dist/number.js.map

@@ -1 +1 @@
-{"version":3,"file":"number.js","sourceRoot":"","sources":["../src/number.ts"],"names":[],"mappings":";;;AA4CA,wBAmBC;AA/DD,wBAAgD;AAEhD;;;;;;GAMG;AACI,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,GAAW,EAAE,EAAE,CAChD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;AAD3C,QAAA,OAAO,WACoC;AAEjD,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,GAAW,EAAE,EAAE,CAC7C,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AADzB,QAAA,IAAI,QACqB;AAEtC,sDAAsD;AAC/C,MAAM,OAAO,GAAG,CAAC,IAAc,EAAE,EAAE,CACtC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;AAD7C,QAAA,OAAO,WACsC;AAE1D;;;;;;;;GAQG;AACI,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,MAAc,EAAE,EAAE,CAClD,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AADrB,QAAA,QAAQ,YACa;AAElC;;;;;GAKG;AACI,MAAM,gBAAgB,GAAG,CAAC,CAAkB,EAAE,EAAE,CACnD,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;AAD1C,QAAA,gBAAgB,oBAC0B;AAEvD;;;GAGG;AACH,SAAgB,MAAM,CAClB,OAA0B,EAAE,GAAW,EAAE,GAAW;IAEpD,IAAI,GAAG,CAAC;IACR,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,IAAI,GAAkB,IAAA,SAAM,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAClD,IAAA,gBAAa,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;IAEjD,GAAG,CAAC;QACA,GAAG,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACxB,IAAI,EAAE,CAAC;QAEP,IAAI,IAAI,GAAG,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC9C,CAAC;IACL,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,EAAE;IAEpB,OAAO,GAAG,CAAC;AACf,CAAC"}
+{"version":3,"file":"number.js","sourceRoot":"","sources":["../src/number.ts"],"names":[],"mappings":";;;AAmCA,wBAmBC;AAtDD,wBAAgD;AAEhD;;;;;;GAMG;AACI,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,GAAW,EAAE,EAAE,CAChD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;AAD3C,QAAA,OAAO,WACoC;AAEjD,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,GAAW,EAAE,EAAE,CAC7C,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AADzB,QAAA,IAAI,QACqB;AAEtC,sDAAsD;AAC/C,MAAM,OAAO,GAAG,CAAC,IAAc,EAAE,EAAE,CACtC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;AAD7C,QAAA,OAAO,WACsC;AAE1D;;;;;;;;GAQG;AACI,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,cAAsB,EAAE,EAAE,CAC1D,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;AAD7B,QAAA,QAAQ,YACqB;AAE1C;;;GAGG;AACH,SAAgB,MAAM,CAClB,OAA0B,EAAE,GAAW,EAAE,GAAW;IAEpD,IAAI,GAAG,CAAC;IACR,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,IAAI,GAAkB,IAAA,SAAM,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAClD,IAAA,gBAAa,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;IAEjD,GAAG,CAAC;QACA,GAAG,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACxB,IAAI,EAAE,CAAC;QAEP,IAAI,IAAI,GAAG,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC9C,CAAC;IACL,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,EAAE;IAEpB,OAAO,GAAG,CAAC;AACf,CAAC"}

package/dist/state-manager.d.ts

@@ -0,0 +1,74 @@
+import type { Action, actSubFct, lsOptions, stateSubFct } from './@state.types';
+import { KeysOfValueType } from '.';
+export declare class StateManager<State extends {}, Act extends Action<any, any> = Action<any, any>, Key extends Extract<keyof State, string> = Extract<keyof State, string>> {
+    private prevState;
+    private emittedState;
+    private state;
+    private readonly useLS;
+    private stateSubDict;
+    private actionSubDict;
+    private stateWasUpdated;
+    private keysChanged;
+    private throttledState;
+    private throttlersRunning;
+    /**
+     * The local storage takes an id, this id
+     * should be unique in order to ensure that the
+     * storage is unique to the given state object
+     */
+    constructor(initialState: State, useLocalStorage?: lsOptions<Key>);
+    getState: () => State;
+    setState: (updateState: Partial<State>) => Promise<State>;
+    action: <A extends Act = Act>(action: A | A["type"]) => A | A["type"];
+    /**
+     * Aggregates state updates by this method over the course of
+     * `msCycle` time and sets the state only once per `msCycle` time.
+     *
+     * Different `msCycle` timings run on separate loops, therefore can
+     * run multiple `msCycle` at the same time.
+     *
+     * To keep state consistent and to prevent bugs, any key run-ins set
+     * in previous `msCycle`(s) will be overwritten by latest
+     * `throttledSetState()` call.
+     *
+     * Will wait the full designated time in `msCycle` on first run.
+     */
+    throttledSetState: (msCycle: number, updateState: Partial<State>) => Promise<void>;
+    private throttledStateSetter;
+    /**
+     * Will execute the given function on state change. Subscribe to
+     * specific key(s) changes in state by setting keys to the desired
+     * key(s) to sub to. Set `keys: true` to sub to all state changes.
+     */
+    stateSub: <K extends Key = Key>(keys: true | K[] | K, fct: stateSubFct<State>, fireOnInitSub?: boolean) => {
+        unsubscribe: () => boolean;
+    };
+    /** set `true` if to subscribe to all actions */
+    actionSub: <T extends Act["type"] = Act["type"], A extends Extract<Act, {
+        type: T;
+    }> = Extract<Act, {
+        type: T;
+    }>>(actions: true | T | T[], fct: actSubFct<A, State>) => {
+        unsubscribe: () => boolean;
+    };
+    /**
+     * Allows you to toggle any key with a boolean value true/false.
+     */
+    toggle: (key: KeysOfValueType<State, boolean>) => Promise<State>;
+    /**
+     * Erases local storage managed by this instance of StateManager,
+     * & removes all properties/methods on the object. (This way any
+     * attempts of accessing the object should return an error);
+     *
+     * (For debugging purposes):
+     * Object will have this appearance afterwards:
+     * ```js
+     * { type: 'StateManager', destroyed: true }
+     * ```
+     */
+    destroy: () => void;
+    cloneKey: <K extends Key>(key: K) => State[K];
+    private stateChanged;
+    private stateFromLS;
+    private updateLocalStorage;
+}

package/dist/state-manager.js

@@ -0,0 +1,227 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StateManager = void 0;
+const _1 = require(".");
+class StateManager {
+    prevState = null;
+    emittedState = null;
+    state;
+    useLS = false;
+    stateSubDict = {};
+    actionSubDict = {};
+    stateWasUpdated = true;
+    keysChanged = {};
+    throttledState = {};
+    throttlersRunning = {};
+    /**
+     * The local storage takes an id, this id
+     * should be unique in order to ensure that the
+     * storage is unique to the given state object
+     */
+    constructor(initialState, useLocalStorage) {
+        let state = {};
+        if (useLocalStorage) {
+            const { useKeys, ignoreKeys, id } = useLocalStorage;
+            if (useKeys && ignoreKeys)
+                throw Error('"useKeys" & "ignoreKeys" are mutually '
+                    + 'exclusive, only use one or the other.');
+            this.useLS = useLocalStorage;
+            const lsId = this.useLS.id = id + '-utilStateManager';
+            state = {
+                ...initialState,
+                ...this.stateFromLS(),
+            };
+            addEventListener('storage', (e) => {
+                if (e.key !== lsId)
+                    return;
+                let fromLS = this.stateFromLS();
+                if (useKeys)
+                    fromLS = (0, _1.objExtract)(fromLS, useKeys);
+                else if (ignoreKeys)
+                    ignoreKeys.forEach((key) => delete fromLS[key]);
+                if ((0, _1.equal)(this.state, { ...this.state, ...fromLS }))
+                    return;
+                this.setState(fromLS);
+            });
+        }
+        else {
+            state = initialState;
+        }
+        this.state = state;
+        this.setState(state);
+    }
+    getState = () => this.state;
+    setState = async (updateState) => {
+        // Do this, otherwise you are mutating the value.
+        // (Would make bugs in this case)
+        this.state = { ...this.state, ...updateState };
+        this.stateWasUpdated = true;
+        await this.stateChanged();
+        return this.getState();
+    };
+    action = (action) => {
+        if ((0, _1.isType)(action, 'string'))
+            action = { type: action };
+        const state = this.getState();
+        for (const k in this.actionSubDict)
+            this.actionSubDict[k]?.(action, state);
+        return action;
+    };
+    // -- State Set Throttler -- //
+    /**
+     * Aggregates state updates by this method over the course of
+     * `msCycle` time and sets the state only once per `msCycle` time.
+     *
+     * Different `msCycle` timings run on separate loops, therefore can
+     * run multiple `msCycle` at the same time.
+     *
+     * To keep state consistent and to prevent bugs, any key run-ins set
+     * in previous `msCycle`(s) will be overwritten by latest
+     * `throttledSetState()` call.
+     *
+     * Will wait the full designated time in `msCycle` on first run.
+     */
+    throttledSetState = async (msCycle, updateState) => {
+        if (!this.throttledState[msCycle])
+            this.throttledState[msCycle] = {};
+        const tsKeys = (0, _1.objKeys)(this.throttledState);
+        for (const k in updateState) {
+            this.throttledState[msCycle][k] = updateState[k];
+            tsKeys.forEach((tsKey) => // To keep state consistent
+             this.throttledState[tsKey][k] = updateState[k]);
+        }
+        this.throttledStateSetter(msCycle);
+    };
+    throttledStateSetter = async (msCycle) => {
+        if (this.throttlersRunning[msCycle])
+            return;
+        this.throttlersRunning[msCycle] = true;
+        await (0, _1.wait)(msCycle);
+        while (this.throttledState[msCycle]) {
+            this.setState(this.throttledState[msCycle]);
+            delete this.throttledState[msCycle];
+            await (0, _1.wait)(msCycle);
+        }
+        this.throttlersRunning[msCycle] = false;
+    };
+    // -- State Set Throttler -- //
+    /**
+     * Will execute the given function on state change. Subscribe to
+     * specific key(s) changes in state by setting keys to the desired
+     * key(s) to sub to. Set `keys: true` to sub to all state changes.
+     */
+    stateSub = (keys, fct, fireOnInitSub = false) => {
+        if ((0, _1.isType)(keys, 'array') && keys.length === 1)
+            keys = keys[0];
+        let f = fct;
+        if ((0, _1.isType)(keys, 'string'))
+            f = (s, prev) => {
+                if (this.keysChanged[keys])
+                    return fct(s, prev);
+            };
+        else if ((0, _1.isType)(keys, 'array'))
+            f = (s, prev) => {
+                for (const k of keys)
+                    if (this.keysChanged[k])
+                        return fct(s, prev);
+            };
+        if (fireOnInitSub)
+            (0, _1.wait)(0).then(() => fct(this.state, this.prevState));
+        const id = Math.random();
+        this.stateSubDict[id] = f;
+        return { unsubscribe: () => delete this.stateSubDict[id] };
+    };
+    /** set `true` if to subscribe to all actions */
+    actionSub = (actions, fct) => {
+        if ((0, _1.isType)(actions, 'array') && actions.length === 1)
+            actions = actions[0];
+        let f = fct;
+        if ((0, _1.isType)(actions, 'string'))
+            f = (a, s) => {
+                if (a.type === actions)
+                    return fct(a, s);
+            };
+        else if ((0, _1.isType)(actions, 'array'))
+            f = (a, s) => {
+                for (const act of actions)
+                    if (a.type === act)
+                        return fct(a, s);
+            };
+        const id = Math.random();
+        this.actionSubDict[id] = f;
+        return { unsubscribe: () => delete this.actionSubDict[id] };
+    };
+    /**
+     * Allows you to toggle any key with a boolean value true/false.
+     */
+    toggle = (key) => this.setState({ [key]: (!this.getState()[key]) });
+    /**
+     * Erases local storage managed by this instance of StateManager,
+     * & removes all properties/methods on the object. (This way any
+     * attempts of accessing the object should return an error);
+     *
+     * (For debugging purposes):
+     * Object will have this appearance afterwards:
+     * ```js
+     * { type: 'StateManager', destroyed: true }
+     * ```
+     */
+    destroy = () => {
+        if (this.useLS)
+            localStorage.removeItem(this.useLS.id);
+        (0, _1.objKeys)(this).forEach(k => delete this[k]);
+        this.type = 'StateManager';
+        this.destroyed = true;
+    };
+    cloneKey = (key) => (0, _1.clone)(this.state[key]);
+    stateChanged = async () => {
+        // Ensures to run only after all sync code updates the state.
+        await (0, _1.wait)(0);
+        if (!this.stateWasUpdated)
+            return false;
+        let stateDidNotChange = true;
+        (0, _1.objKeys)(this.state).forEach((k) => {
+            const em = this.emittedState || {};
+            if ( // only check equality if not already changed.
+            !this.keysChanged[k] && (0, _1.equal)(this.state[k], em[k]))
+                return;
+            stateDidNotChange = false;
+            this.keysChanged[k] = true;
+        });
+        if (stateDidNotChange)
+            return this.stateWasUpdated = false;
+        this.updateLocalStorage();
+        // these 3 need to be set before iterating over subs
+        // else prevState wont be accurately emitted
+        this.prevState = this.emittedState;
+        this.emittedState = this.state;
+        this.state = { ...this.state }; // use obj spread (or get bugs)!
+        for (const k in this.stateSubDict)
+            this.stateSubDict[k]?.(this.state, this.prevState);
+        this.keysChanged = {};
+        this.stateWasUpdated = false;
+        return true;
+    };
+    stateFromLS = () => {
+        if (!this.useLS)
+            return;
+        const { id } = this.useLS;
+        const strState = localStorage.getItem(id);
+        if (!strState)
+            return {};
+        return JSON.parse(strState);
+    };
+    updateLocalStorage = () => {
+        if (!this.useLS)
+            return;
+        const { id, ignoreKeys, useKeys } = this.useLS;
+        let state = { ...this.state };
+        if (ignoreKeys)
+            ignoreKeys.forEach((key) => delete state[key]);
+        else if (useKeys)
+            state = (0, _1.objExtract)(state, useKeys);
+        localStorage.setItem(id, JSON.stringify(state));
+    };
+}
+exports.StateManager = StateManager;
+//# sourceMappingURL=state-manager.js.map

package/dist/state-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-manager.js","sourceRoot":"","sources":["../src/state-manager.ts"],"names":[],"mappings":"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"}

package/dist/time.d.ts

@@ -1,5 +1,9 @@
 import { Temporal } from '@js-temporal/polyfill';
 import { AnyDate, MsTime, num, str, TimeArr, TimeObj } from '.';
+/** A promise that waits `ms` amount of milliseconds to execute */
+export declare const wait: (ms: number) => Promise<void>;
+/** Resolves after a given msEpoch passes. `msEpoch - Date.now()` */
+export declare const waitUntil: (msEpoch: number) => Promise<void>;
 export declare const msTime: MsTime;
 export declare const weekTuple: readonly ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
 /**
@@ -35,6 +39,7 @@ export declare const time: {
         /** fnc(n)  -> add min to now */
         readonly min: (n: num) => number;
     };
+    /** Convert ms into: */
     readonly msTo: {
         /** fnc(n)  -> from ms to num of seconds */
         readonly sec: (ms: num) => number;
@@ -51,7 +56,10 @@ export declare const time: {
 };
 export declare const humanizedTime: (date: AnyDate) => string | null;
 /** A Date substitute, to make working with time easier and more versatile */
-export declare function getTime(t: TimeArr | num | str, timeZone?: str): {
+export declare function getTime(t?: TimeArr | num | str, 
+/** For a list of available timeZone values run:
+ * `Intl.supportedValuesOf('timeZone');` */
+timeZone?: str): {
     zonedTemporal: Temporal.ZonedDateTime;
     date: Date;
     tzOffsetMin: number;

package/dist/time.js

@@ -1,11 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.timeObj = exports.humanizedTime = exports.time = exports.weekTuple = exports.msTime = void 0;
+exports.timeObj = exports.humanizedTime = exports.time = exports.weekTuple = exports.msTime = exports.waitUntil = exports.wait = void 0;
 exports.dateTimeToString = dateTimeToString;
 exports.getTime = getTime;
 exports.parseDate = parseDate;
 const polyfill_1 = require("@js-temporal/polyfill");
 const _1 = require(".");
+/** A promise that waits `ms` amount of milliseconds to execute */
+const wait = (ms) => new Promise((res) => setTimeout(() => res(), ms));
+exports.wait = wait;
+/** Resolves after a given msEpoch passes. `msEpoch - Date.now()` */
+const waitUntil = (msEpoch) => new Promise(res => setTimeout(res, msEpoch - Date.now()));
+exports.waitUntil = waitUntil;
 exports.msTime = {
     s: 1000,
     m: 60000,
@@ -53,6 +59,7 @@ exports.time = {
         /** fnc(n)  -> add min to now */
         min: (n) => Date.now() + n * exports.msTime.m,
     },
+    /** Convert ms into: */
     msTo: {
         /** fnc(n)  -> from ms to num of seconds */
         sec: (ms) => ms / exports.msTime.s,
@@ -95,9 +102,13 @@ const humanizedTime = (date) => {
     }
 };
 exports.humanizedTime = humanizedTime;
-// Intl.supportedValuesOf('timeZone');
 /** A Date substitute, to make working with time easier and more versatile */
-function getTime(t, timeZone) {
+function getTime(t, 
+/** For a list of available timeZone values run:
+ * `Intl.supportedValuesOf('timeZone');` */
+timeZone) {
+    if (t === undefined)
+        t = Date.now();
     timeZone = timeZone || Intl.DateTimeFormat().resolvedOptions().timeZone;
     let zonedTemporal;
     let date;
@@ -151,7 +162,7 @@ const timeObj = (dt) => dt instanceof Date ? ({
     min: dt.minute,
     sec: dt.second,
     ms: dt.millisecond,
-    wDay: exports.weekTuple[dt.dayOfWeek]
+    wDay: exports.weekTuple[dt.dayOfWeek - 1]
 });
 exports.timeObj = timeObj;
 function parseDate(d) {

package/dist/time.js.map

@@ -1 +1 @@
-{"version":3,"file":"time.js","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@giveback007/util-lib",
-    "version": "2.1.2",
+    "version": "2.2.0",
     "description": "Utility library",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",

package/src/@state.types.ts

@@ -0,0 +1,19 @@
+export type Immutable<T> = {
+    readonly [K in keyof T]: Immutable<T[K]>;
+};
+
+export type Action<T extends string, D = undefined> =
+    Readonly<D extends undefined ? {type: T} : { type: T; data: D; }>;
+
+export type stateSubFct<S> = (s: S, prev: S | null) => any;
+
+export type actSubFct<
+    A extends Action<any, any>,
+    S = any
+> = (a: A, s: S) => any;
+
+export type lsOptions<P> = {
+    id: string;
+    useKeys?: P[];
+    ignoreKeys?: P[];
+};

package/src/@types.ts

@@ -5,8 +5,9 @@ export type StrKeys<T> = Extract<keyof T, string>;
 
 export type Omit<T, K> = Pick<T, Exclude<keyof T, K>>;
 
-export type Optional<T, K extends keyof T = keyof T> =
-    { [P in K]?: T[P] };
+export type Optional<
+    T, K extends keyof T = keyof T
+> = { [P in K]?: T[P] };
 
 export type ResolvedValue<T> =
     T extends Promise <infer U> ? U : any;
@@ -62,9 +63,13 @@ export type MsTime = {
  * type Y => "k1" | "k3"
  * ```
  */
- export type KeysOfValueType<O, T> = { [I in keyof O]: O[I] extends T ? I : never }[keyof O];
+ export type KeysOfValueType<O, T> = {
+    [I in keyof O]: O[I] extends T ? I : never
+}[keyof O];
 
- export type AwaitReturn<T extends AnyFnc<any | Promise<any>>> = Awaited<ReturnType<T>>;
+ export type AwaitReturn<
+    T extends AnyFnc<any | Promise<any>>
+> = Awaited<ReturnType<T>>;
 
 export type num = number;
 export type str = string;
@@ -72,7 +77,14 @@ export type bol = boolean;
 
 export type AnyFnc<T = any> = (...args: any[]) => T;
 
-export type DayOfWeek = 'Sun' | 'Mon' | 'Tue' | 'Wed' | 'Thu' | 'Fri' | 'Sat';
+export type DayOfWeek =
+    | 'Sun'
+    | 'Mon'
+    | 'Tue'
+    | 'Wed'
+    | 'Thu'
+    | 'Fri'
+    | 'Sat';
 
 export type TimeObj = {
     y:      num;
@@ -85,18 +97,16 @@ export type TimeObj = {
     wDay:   DayOfWeek;
 };
 
-export type PartialTimeObj = {
-    y:      num;
-    m?:     num;
-    d?:     num;
-    h?:     num;
-    min?:   num;
-    sec?:   num;
-    ms?:    num;
-};
-
-export type TimeArr = [y: num, m?: num, d?: num, h?: num, min?: num, sec?: num, ms?: num];
-
-export type AnyDate = string | number | Date | TimeObj | PartialTimeObj | TimeArr;
+export type TimeArr = [
+    y: num,
+    m?: num,
+    d?: num,
+    h?: num,
+    min?: num,
+    sec?: num,
+    ms?: num
+];
+
+export type AnyDate = string | number | Date | TimeObj | TimeArr;
 
 export type Dict<T> = { [id: string]: T };

package/src/general.ts

@@ -39,10 +39,6 @@ export const interval = (
     };
 }
 
-/** A promise that waits `ms` amount of milliseconds to execute */
-export const wait = (ms: number): Promise<void> =>
-    new Promise((res) => setTimeout(() => res(), ms));
-
 const usubAllFunct = (x: any, unsubName = 'unsubscribe') =>
     isType(x, 'object')
     &&

package/src/index.ts

@@ -1,12 +1,14 @@
 export * from './@types';
+export * from './@state.types'
 export * from './array';
 export * from './clone';
 export * from './equality';
 export * from './general';
+export * from './http';
 export * from './iterate';
 export * from './number';
 export * from './object';
+export * from './state-manager';
 export * from './string';
 export * from './test';
-export * from './time';
-export * from './http';
+export * from './time';

package/src/number.ts

@@ -26,17 +26,8 @@ export const average = (nArr: number[]) =>
  * decPlaces(1.1276, 2) //=> 1.13
  * ```
  */
-export const decPlace = (n: number, places: number) =>
-    parseFloat(n.toFixed(places));
-
-/**
- * @example
- * ```js
- * numberWithCommas(1000000) //=> '1,000,000'
- * ```
- */
-export const numberWithCommas = (n: number | string) =>
-    n.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+export const numFixed = (n: number, fractionDigits: number) =>
+    parseFloat(n.toFixed(fractionDigits));
 
 /**
  * Takes a number || number[] and min & max, will generate a

package/src/state-manager.ts

@@ -0,0 +1,301 @@
+import type {
+    Action, actSubFct, lsOptions, stateSubFct
+} from './@state.types';
+
+import {
+    Dict, KeysOfValueType
+} from '.'
+
+import {
+    wait, equal, objExtract,
+    isType, objKeys, clone
+} from '.';
+
+export class StateManager<
+    State extends {},
+    Act extends Action<any, any> = Action<any, any>,
+    Key extends Extract<keyof State, string> = Extract<keyof State, string>
+> {
+
+    private prevState: State | null = null;
+    private emittedState: State | null = null;
+    private state: State;
+
+    private readonly useLS: lsOptions<Key> | false = false;
+
+    private stateSubDict: Dict<stateSubFct<State>> = {};
+    private actionSubDict: Dict<actSubFct<Act>> = {};
+
+    private stateWasUpdated = true;
+    private keysChanged: { [K in Key]?: true } = {};
+
+    private throttledState: Dict<Partial<State>> = {};
+    private throttlersRunning: Dict<boolean> = {};
+    /**
+     * The local storage takes an id, this id
+     * should be unique in order to ensure that the
+     * storage is unique to the given state object
+     */
+    constructor(
+        initialState: State,
+        useLocalStorage?: lsOptions<Key>
+    ) {
+        let state = {} as State;
+
+        if (useLocalStorage) {
+            const { useKeys, ignoreKeys, id } = useLocalStorage;
+
+            if (useKeys && ignoreKeys) throw Error(
+                '"useKeys" & "ignoreKeys" are mutually '
+                + 'exclusive, only use one or the other.'
+            );
+
+            this.useLS = useLocalStorage;
+            const lsId = this.useLS.id = id + '-utilStateManager';
+
+            state = {
+                ...initialState,
+                ...this.stateFromLS(),
+            };
+
+            addEventListener('storage', (e: StorageEvent) => {
+                if (e.key !== lsId) return;
+
+                let fromLS = this.stateFromLS();
+
+                if (useKeys)
+                    fromLS = objExtract(fromLS, useKeys);
+                else if (ignoreKeys)
+                    ignoreKeys.forEach((key) => delete fromLS[key]);
+
+                if (equal(this.state, { ...this.state, ...fromLS })) return;
+
+                this.setState(fromLS);
+            });
+        } else {
+            state = initialState;
+        }
+
+        this.state = state;
+        this.setState(state);
+    }
+
+    getState = () => this.state;
+
+    setState = async (updateState: Partial<State>) => {
+        // Do this, otherwise you are mutating the value.
+        // (Would make bugs in this case)
+        this.state = { ...this.state, ...updateState };
+
+        this.stateWasUpdated = true;
+        await this.stateChanged();
+        return this.getState();
+    }
+
+    action = <A extends Act = Act>(action: A | A['type']) => {
+        if (isType(action, 'string')) action = { type: action } as A;
+        const state = this.getState();
+
+        for (const k in this.actionSubDict)
+            this.actionSubDict[k]?.(action, state);
+
+        return action;
+    }
+
+    // -- State Set Throttler -- //
+    /**
+     * Aggregates state updates by this method over the course of
+     * `msCycle` time and sets the state only once per `msCycle` time.
+     *
+     * Different `msCycle` timings run on separate loops, therefore can
+     * run multiple `msCycle` at the same time.
+     *
+     * To keep state consistent and to prevent bugs, any key run-ins set
+     * in previous `msCycle`(s) will be overwritten by latest
+     * `throttledSetState()` call.
+     *
+     * Will wait the full designated time in `msCycle` on first run.
+     */
+    throttledSetState = async (
+        msCycle: number,
+        updateState: Partial<State>
+    ) => {
+        if (!this.throttledState[msCycle])
+            this.throttledState[msCycle] = {};
+
+        const tsKeys = objKeys(this.throttledState);
+        for (const k in updateState) {
+            this.throttledState[msCycle][k] = updateState[k];
+
+            tsKeys.forEach((tsKey) => // To keep state consistent
+                this.throttledState[tsKey]![k] = updateState[k]);
+        }
+
+        this.throttledStateSetter(msCycle);
+    }
+
+    private throttledStateSetter = async (msCycle: number) => {
+        if (this.throttlersRunning[msCycle]) return;
+        this.throttlersRunning[msCycle] = true;
+
+        await wait(msCycle);
+        while (this.throttledState[msCycle]) {
+            this.setState(this.throttledState[msCycle]);
+            delete this.throttledState[msCycle];
+            await wait(msCycle);
+        }
+
+        this.throttlersRunning[msCycle] = false;
+    }
+    // -- State Set Throttler -- //
+
+    /**
+     * Will execute the given function on state change. Subscribe to
+     * specific key(s) changes in state by setting keys to the desired
+     * key(s) to sub to. Set `keys: true` to sub to all state changes.
+     */
+    stateSub = <K extends Key = Key>(
+        keys: true | K[] | K,
+        fct: stateSubFct<State>,
+        fireOnInitSub = false
+    ) => {
+        if (isType(keys, 'array') && keys.length === 1)
+            keys = keys[0]!;
+
+        let f = fct;
+
+        if (isType(keys, 'string')) f = (s, prev) => {
+            if (this.keysChanged[keys as K]) return fct(s, prev);
+        }
+
+        else if (isType(keys, 'array')) f = (s, prev) => {
+            for (const k of keys as K[])
+                if (this.keysChanged[k]) return fct(s, prev);
+        }
+
+        if (fireOnInitSub)
+            wait(0).then(() => fct(this.state, this.prevState));
+
+        const id = Math.random();
+        this.stateSubDict[id] = f as any;
+        return { unsubscribe: () => delete this.stateSubDict[id] };
+    }
+
+    /** set `true` if to subscribe to all actions */
+    actionSub = <
+        T extends Act['type'] = Act['type'],
+        A extends Extract<Act, { type: T }> = Extract<Act, { type: T }>
+    >(
+        actions: true | T | T[],
+        fct: actSubFct<A, State>
+    ) => {
+        if (isType(actions, 'array') && actions.length === 1)
+            actions = actions[0]!;
+
+        let f = fct;
+
+        if (isType(actions, 'string')) f = (a, s) => {
+            if (a.type === actions) return fct(a, s);
+        }
+
+        else if (isType(actions, 'array')) f = (a, s) => {
+            for (const act of actions as T['type'][])
+                if (a.type === act) return fct(a, s);
+        }
+
+        const id = Math.random();
+        this.actionSubDict[id] = f as any;
+        return { unsubscribe: () => delete this.actionSubDict[id] };
+    }
+
+    /**
+     * Allows you to toggle any key with a boolean value true/false.
+     */
+    toggle = (key: KeysOfValueType<State, boolean>) =>
+        this.setState({ [key]: (!this.getState()[key]) } as any);
+
+    /**
+     * Erases local storage managed by this instance of StateManager,
+     * & removes all properties/methods on the object. (This way any
+     * attempts of accessing the object should return an error);
+     *
+     * (For debugging purposes):
+     * Object will have this appearance afterwards:
+     * ```js
+     * { type: 'StateManager', destroyed: true }
+     * ```
+     */
+    destroy = () => {
+        if (this.useLS)
+            localStorage.removeItem(this.useLS.id);
+
+        objKeys(this).forEach(k => delete this[k]);
+        (this as any).type = 'StateManager';
+        (this as any).destroyed = true;
+    }
+
+    cloneKey =
+        <K extends Key>(key: K): State[K] => clone(this.state[key]);
+
+    private stateChanged = async () => {
+        // Ensures to run only after all sync code updates the state.
+        await wait(0);
+        if (!this.stateWasUpdated) return false;
+
+        let stateDidNotChange = true;
+
+        objKeys(this.state).forEach((k) => {
+            const em = this.emittedState || {} as Partial<State>;
+
+            if (// only check equality if not already changed.
+                !this.keysChanged[k as Key] && equal(this.state[k], em[k])
+            ) return;
+
+            stateDidNotChange = false;
+            this.keysChanged[k as Key] = true;
+        });
+
+        if (stateDidNotChange)
+            return this.stateWasUpdated = false;
+
+        this.updateLocalStorage();
+
+        // these 3 need to be set before iterating over subs
+        // else prevState wont be accurately emitted
+        this.prevState = this.emittedState;
+        this.emittedState = this.state;
+        this.state = { ...this.state }; // use obj spread (or get bugs)!
+
+        for (const k in this.stateSubDict)
+            this.stateSubDict[k]?.(this.state, this.prevState as State);
+
+        this.keysChanged = {};
+        this.stateWasUpdated = false;
+        return true;
+    }
+
+    private stateFromLS = () => {
+        if (!this.useLS) return;
+
+        const { id } = this.useLS;
+        const strState = localStorage.getItem(id);
+        if (!strState) return {};
+
+        return JSON.parse(strState);
+    }
+
+    private updateLocalStorage = () => {
+        if (!this.useLS) return;
+
+        const { id, ignoreKeys, useKeys } = this.useLS;
+
+        let state = { ...this.state };
+
+        if (ignoreKeys)
+            ignoreKeys.forEach((key) => delete state[key]);
+        else if (useKeys)
+            state = objExtract(state, useKeys);
+
+        localStorage.setItem(id, JSON.stringify(state));
+    }
+}

package/src/time.ts

@@ -1,6 +1,14 @@
 import { Temporal } from '@js-temporal/polyfill';
 import { AnyDate, isType, MsTime, num, str, TimeArr, TimeObj } from '.';
 
+/** A promise that waits `ms` amount of milliseconds to execute */
+export const wait = (ms: number): Promise<void> =>
+    new Promise((res) => setTimeout(() => res(), ms));
+
+/** Resolves after a given msEpoch passes. `msEpoch - Date.now()` */
+export const waitUntil = (msEpoch: number): Promise<void> =>
+    new Promise(res => setTimeout(res, msEpoch - Date.now()))
+
 export const msTime: MsTime = {
     s: 1000,
     m: 60000,
@@ -56,6 +64,7 @@ export const time = {
         min: (n: num) => Date.now() + n * msTime.m,
     },
 
+    /** Convert ms into: */
     msTo: {
         /** fnc(n)  -> from ms to num of seconds */
         sec: (ms: num) => ms / msTime.s,
@@ -97,13 +106,16 @@ export const humanizedTime = (date: AnyDate) => {
     }
 }
 
-// Intl.supportedValuesOf('timeZone');
 /** A Date substitute, to make working with time easier and more versatile */
 export function getTime(
-    t: TimeArr | num | str,
+    t?: TimeArr | num | str,
+    /** For a list of available timeZone values run:
+     * `Intl.supportedValuesOf('timeZone');` */
     timeZone?: str
 ) {
+    if (t === undefined) t = Date.now();
     timeZone = timeZone || Intl.DateTimeFormat().resolvedOptions().timeZone;
+
     let zonedTemporal: Temporal.ZonedDateTime;
     let date: Date;
     let isoStr: str;
@@ -158,7 +170,7 @@ export const timeObj = (dt: Date | Temporal.ZonedDateTime): TimeObj => dt instan
     min: dt.minute,
     sec: dt.second,
     ms: dt.millisecond,
-    wDay: weekTuple[dt.dayOfWeek]!
+    wDay: weekTuple[dt.dayOfWeek - 1]!
 });
 
 export function parseDate(d: AnyDate) {