@leyyo/common 1.2.7 → 1.3.1

package/dist/common/array.fn.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.newRepoArray = newRepoArray;
+exports.removeRepoArray = removeRepoArray;
+exports.clearRepoArray = clearRepoArray;
+exports.listRepoArrays = listRepoArrays;
+exports.printRepoArrays = printRepoArrays;
+const function_1 = require("../function");
+const error_1 = require("../error");
+const internal_1 = require("../internal");
+// region properties
+/**
+ * Internal items which stores collections
+ * */
+const items = new Map();
+/**
+ * Internal volatiles repo which could be cleared after lifecycle run
+ * */
+const volatiles = new Set();
+/**
+ * Identifier of file
+ * */
+const where = `${internal_1.FQN}.ArrayFn`;
+// endregion properties
+// noinspection JSUnusedGlobalSymbols
+/**
+ * Create new array
+ *
+ * @param {string} name - name of collection
+ * @param {boolean} volatile - if yes: it will be removed after lifecycle run
+ * @return {Array<any>}
+ * */
+function newRepoArray(name, volatile) {
+    if (!(0, function_1.isText)(name)) {
+        throw new error_1.DeveloperError('Invalid new array name', 'newArray#01', where);
+    }
+    const item = [];
+    const code = Symbol.for(name.split('#').join(''));
+    items.set(code, item);
+    if (volatile) {
+        volatiles.add(code);
+    }
+    return item;
+}
+// noinspection JSUnusedGlobalSymbols
+/**
+ * Remove array by given key
+ *
+ * @param {symbol} key - key of collection
+ * @return {number}
+ *
+ * Return possibilities:
+ *  - `-2`: key is not valid symbol
+ *  - `-1`: key does not exist
+ *  - `>= 0`: length of removed items in collection
+ * */
+function removeRepoArray(key) {
+    const cleared = clearRepoArray(key);
+    if (cleared >= 0) {
+        items.delete(key);
+        if (volatiles.has(key)) {
+            volatiles.delete(key);
+        }
+    }
+    return cleared;
+}
+/**
+ * Clear array by given key
+ *
+ * @param {symbol} key - key of collection
+ * @return {number}
+ *
+ * Return possibilities:
+ *  - `-2`: key is not valid symbol
+ *  - `-1`: key does not exist
+ *  - `>= 0`: length of cleared items in collection
+ * */
+function clearRepoArray(key) {
+    if (typeof key !== 'symbol') {
+        return -2;
+    }
+    if (!items.has(key)) {
+        return -1;
+    }
+    const item = items.get(key);
+    const length = item.length;
+    item.splice(0, length);
+    return length;
+}
+// noinspection JSUnusedGlobalSymbols
+/**
+ * List all array keys
+ *
+ * @return {Array<symbol>}
+ * */
+function listRepoArrays() {
+    return Array.from(items.keys());
+}
+// noinspection JSUnusedGlobalSymbols
+/**
+ * Print all arrays
+ *
+ * @return {Record} - as {key: length of collection}
+ *
+ * Note: if stringified symbol is duplicated, add index postfix with `#` symbol
+ * */
+function printRepoArrays() {
+    const result = {};
+    let index = 0;
+    for (const [sym, item] of items.entries()) {
+        const key = sym.description;
+        if (result[key] === undefined) {
+            result[key] = item.length;
+            index = 0;
+        }
+        else {
+            index++;
+            result[`${key}#${index}`] = item.length;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=array.fn.js.map

package/dist/common/array.fn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.fn.js","sourceRoot":"","sources":["../../src/common/array.fn.ts"],"names":[],"mappings":";;AA6BA,oCAWC;AAcD,0CASC;AAaD,wCAWC;AAQD,wCAEC;AAUD,0CAeC;AA1HD,0CAAmC;AACnC,oCAAwC;AACxC,0CAAgC;AAEhC,oBAAoB;AACpB;;KAEK;AACL,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEhD;;KAEK;AACL,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;AAEpC;;KAEK;AACL,MAAM,KAAK,GAAG,GAAG,cAAG,UAAU,CAAC;AAC/B,uBAAuB;AAEvB,qCAAqC;AACrC;;;;;;KAMK;AACL,SAAgB,YAAY,CAAI,IAAY,EAAE,QAAkB;IAC5D,IAAI,CAAC,IAAA,iBAAM,EAAC,IAAI,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,sBAAc,CAAC,wBAAwB,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,IAAI,GAAG,EAAc,CAAC;IAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtB,IAAI,QAAQ,EAAE,CAAC;QACX,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,qCAAqC;AACrC;;;;;;;;;;KAUK;AACL,SAAgB,eAAe,CAAC,GAAW;IACvC,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACf,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClB,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;;;;;;;;;KAUK;AACL,SAAgB,cAAc,CAAC,GAAW;IACtC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,CAAC,CAAC,CAAC;IACd,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,CAAC,CAAC,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACvB,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,qCAAqC;AACrC;;;;KAIK;AACL,SAAgB,cAAc;IAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,qCAAqC;AACrC;;;;;;KAMK;AACL,SAAgB,eAAe;IAC3B,MAAM,MAAM,GAAG,EAA4B,CAAC;IAC5C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC;QAC5B,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;YAC1B,KAAK,GAAG,CAAC,CAAC;QACd,CAAC;aACI,CAAC;YACF,KAAK,EAAE,CAAC;YACR,MAAM,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5C,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/common/deploy.fn.d.ts

@@ -0,0 +1,18 @@
+import { Fnc } from "../index.types";
+/**
+ * Wait deploy of a component
+ *
+ * @param {string} name - name of component
+ * @param {function} callback - callback for creator of component, if it completes it, this callback will be called
+ * */
+export declare function waitDeploy(name: string, callback: Fnc): void;
+/**
+ * Complete deploy of a component
+ * - It should be called by owner of component
+ *
+ *
+ *
+ * @param {string} name - name of component
+ * @param {...Array} values - They will be sent to callback of waiting component, {@link waitDeploy}
+ * */
+export declare function completeDeploy(name: string, ...values: Array<unknown>): void;

package/dist/common/deploy.fn.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitDeploy = waitDeploy;
+exports.completeDeploy = completeDeploy;
+const function_1 = require("../function");
+const error_1 = require("../error");
+const internal_1 = require("../internal");
+const map_fn_1 = require("./map.fn");
+// region properties
+const where = `${internal_1.FQN}.DeployFn`;
+const waitingCallbacks = (0, map_fn_1.newRepoMap)(`${where}.waitingCallbacks`);
+const alreadyDeployed = (0, map_fn_1.newRepoMap)(`${where}.alreadyDeployed`);
+// endregion properties
+// noinspection JSUnusedGlobalSymbols
+/**
+ * Wait deploy of a component
+ *
+ * @param {string} name - name of component
+ * @param {function} callback - callback for creator of component, if it completes it, this callback will be called
+ * */
+function waitDeploy(name, callback) {
+    if (!(0, function_1.isText)(name)) {
+        throw new error_1.DeveloperError('Invalid event name', 'onDeployed#01', where);
+    }
+    if (typeof callback !== 'function') {
+        throw new error_1.DeveloperError('Invalid event callback', 'onDeployed#02', where);
+    }
+    if (alreadyDeployed.has(name)) {
+        try {
+            callback(...alreadyDeployed.get(name));
+        }
+        catch (e) {
+            new error_1.DeveloperError('Raised callback run', 'onDeployed#03', where).log(e);
+        }
+        return;
+    }
+    if (!waitingCallbacks.has(name)) {
+        waitingCallbacks.set(name, []);
+    }
+    waitingCallbacks.get(name).push(callback);
+}
+// noinspection JSUnusedGlobalSymbols
+/**
+ * Complete deploy of a component
+ * - It should be called by owner of component
+ *
+ *
+ *
+ * @param {string} name - name of component
+ * @param {...Array} values - They will be sent to callback of waiting component, {@link waitDeploy}
+ * */
+function completeDeploy(name, ...values) {
+    if (!(0, function_1.isText)(name)) {
+        throw new error_1.DeveloperError('Invalid event name', 'onDeployed#04', where);
+    }
+    const isNew = !alreadyDeployed.has(name);
+    alreadyDeployed.set(name, values);
+    if (isNew) {
+        if (waitingCallbacks.has(name)) {
+            const callbacks = waitingCallbacks.get(name);
+            waitingCallbacks.delete(name);
+            callbacks.forEach(callback => {
+                try {
+                    callback(...values);
+                }
+                catch (e) {
+                    new error_1.DeveloperError('Raised callback run', 'onDeployed#05', where).log(e);
+                }
+            });
+        }
+    }
+}
+//# sourceMappingURL=deploy.fn.js.map

package/dist/common/deploy.fn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.fn.js","sourceRoot":"","sources":["../../src/common/deploy.fn.ts"],"names":[],"mappings":";;AAmBA,gCAoBC;AAYD,wCAoBC;AAtED,0CAAmC;AACnC,oCAAwC;AACxC,0CAAgC;AAChC,qCAAoC;AAEpC,oBAAoB;AACpB,MAAM,KAAK,GAAG,GAAG,cAAG,WAAW,CAAC;AAChC,MAAM,gBAAgB,GAAG,IAAA,mBAAU,EAAqB,GAAG,KAAK,mBAAmB,CAAC,CAAC;AACrF,MAAM,eAAe,GAAG,IAAA,mBAAU,EAAyB,GAAG,KAAK,kBAAkB,CAAC,CAAC;AACvF,uBAAuB;AAEvB,qCAAqC;AACrC;;;;;KAKK;AACL,SAAgB,UAAU,CAAC,IAAY,EAAE,QAAa;IAClD,IAAI,CAAC,IAAA,iBAAM,EAAC,IAAI,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,sBAAc,CAAC,oBAAoB,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,sBAAc,CAAC,wBAAwB,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACD,QAAQ,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,IAAI,sBAAc,CAAC,qBAAqB,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO;IACX,CAAC;IAED,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC;AACD,qCAAqC;AAErC;;;;;;;;KAQK;AACL,SAAgB,cAAc,CAAC,IAAY,EAAE,GAAG,MAAsB;IAClE,IAAI,CAAC,IAAA,iBAAM,EAAC,IAAI,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,sBAAc,CAAC,oBAAoB,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzC,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAElC,IAAI,KAAK,EAAE,CAAC;QACR,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC7C,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC9B,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBACzB,IAAI,CAAC;oBACD,QAAQ,CAAC,GAAG,MAAM,CAAC,CAAC;gBACxB,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACT,IAAI,sBAAc,CAAC,qBAAqB,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC7E,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/common/enum.fn.d.ts

@@ -0,0 +1,63 @@
+import { EnumData, EnumDefineEagerOpt, EnumDefineLazyOpt, EnumItem } from "../index.types";
+/**
+ * Define an enumeration as eager (with data)
+ *
+ * Options:
+ * - classic enumeration as `enum name {...}`
+ * - literal enumeration as `[...]`
+ *
+ * @param {(EnumData)} data - map or literal readonly array
+ * @param {EnumDefineEagerOpt} opt - enum options
+ * */
+export declare function defineEnum(data: EnumData, opt: EnumDefineEagerOpt): void;
+/**
+ * Define an enumeration as lazy (with path)
+ *
+ * Options:
+ * - classic enumeration as `enum name {...}`
+ * - literal enumeration as `[...]`
+ *
+ * @param {EnumDefineLazyOpt} opt - enum options
+ * */
+export declare function defineLazyEnum(opt: EnumDefineLazyOpt): void;
+/**
+ * Check enum defined as lazy, by name
+ * Note:
+ * - Enum's mode will be shifted lazy to eager after loaded
+ *
+ * @param {string} name - enum name
+ * @return {boolean}
+ * */
+export declare function isEnumLazy(name: string): boolean;
+/**
+ * Check enum defined as eager, by name
+ *
+ * @param {string} name - enum name
+ * @return {boolean}
+ * */
+export declare function isEnumEager(name: string): boolean;
+/**
+ * Check enum defined or not, by name
+ *
+ * @param {string} name - enum name
+ * @return {boolean}
+ * */
+export declare function isEnumDefined(name: string): boolean;
+/**
+ * Get enum by name
+ * Note:
+ * - Enum may be lazy mode, so it has lazy paths without data
+ *
+ * @param {string} name - enum name
+ * @return {EnumItem}
+ * */
+export declare function getEnum(name: string): EnumItem;
+/**
+ * Load lazy enum by name
+ * Note:
+ * - Enum must be exported as `foretell`
+ *
+ * @param {string} name - name of enum
+ * @return {Promise<EnumItem>}
+ * */
+export declare function getLazyEnum(name: string): Promise<EnumItem>;

package/dist/common/enum.fn.js

@@ -0,0 +1,191 @@
+"use strict";
+// noinspection JSUnusedGlobalSymbols
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineEnum = defineEnum;
+exports.defineLazyEnum = defineLazyEnum;
+exports.isEnumLazy = isEnumLazy;
+exports.isEnumEager = isEnumEager;
+exports.isEnumDefined = isEnumDefined;
+exports.getEnum = getEnum;
+exports.getLazyEnum = getLazyEnum;
+const function_1 = require("../function");
+const const_1 = require("../const");
+const internal_1 = require("../internal");
+const map_fn_1 = require("./map.fn");
+const set_fn_1 = require("./set.fn");
+const error_1 = require("../error");
+// region properties
+const where = `${internal_1.FQN}.EnumFn`;
+const items = (0, set_fn_1.newRepoSet)(`${where}.items`);
+const names = (0, map_fn_1.newRepoMap)(`${where}.names`);
+// endregion properties
+/**
+ * Define an enumeration as eager (with data)
+ *
+ * Options:
+ * - classic enumeration as `enum name {...}`
+ * - literal enumeration as `[...]`
+ *
+ * @param {(EnumData)} data - map or literal readonly array
+ * @param {EnumDefineEagerOpt} opt - enum options
+ * */
+function defineEnum(data, opt) {
+    if (!((0, function_1.isFilledObj)(data) || (0, function_1.isFilledArr)(data))) {
+        throw new error_1.DeveloperError('Invalid enum data', 'onDeployed#01', where);
+    }
+    if (!(0, function_1.isFilledObj)(opt)) {
+        throw new error_1.DeveloperError('Invalid enum options', 'onDeployed#01', where);
+    }
+    if (!(0, function_1.isText)(opt.name)) {
+        throw new error_1.DeveloperError('Invalid enum name', 'onDeployed#01', where);
+    }
+    if (isAlreadyDefined(opt.name, data)) {
+        return;
+    }
+    const type = Array.isArray(data) ? 'literal' : 'map';
+    items.add(data);
+    names.set(opt.name, Object.assign(Object.assign({}, opt), { mode: 'eager', type, data }));
+    data[const_1.LY_ENUM_NAME] = opt.name;
+    if ((0, function_1.isFilledObj)(opt.alt)) {
+        data[const_1.LY_ENUM_ALT] = opt.alt;
+    }
+}
+/**
+ * Check conflict case
+ *
+ * @param {string} name - enum name
+ * @param {EnumData} data - enum object or literals
+ * @return {boolean} - if yes: it was already defined
+ * */
+function isAlreadyDefined(name, data) {
+    return data[const_1.LY_ENUM_NAME] && items.has(data) && names.has(name);
+}
+/**
+ * Define an enumeration as lazy (with path)
+ *
+ * Options:
+ * - classic enumeration as `enum name {...}`
+ * - literal enumeration as `[...]`
+ *
+ * @param {EnumDefineLazyOpt} opt - enum options
+ * */
+function defineLazyEnum(opt) {
+    if (!(0, function_1.isFilledObj)(opt)) {
+        throw new error_1.DeveloperError('Invalid enum options', 'onDeployed#01', where);
+    }
+    if (!(opt.lazyData instanceof Promise)) {
+        throw new error_1.DeveloperError('Invalid enum load path', 'onDeployed#01', where);
+    }
+    names.set(opt.name, Object.assign(Object.assign({}, opt), { mode: 'lazy' }));
+}
+/**
+ * Check enum defined as lazy, by name
+ * Note:
+ * - Enum's mode will be shifted lazy to eager after loaded
+ *
+ * @param {string} name - enum name
+ * @return {boolean}
+ * */
+function isEnumLazy(name) {
+    var _a;
+    return ((_a = getEnum(name)) === null || _a === void 0 ? void 0 : _a.mode) === 'lazy';
+}
+/**
+ * Check enum defined as eager, by name
+ *
+ * @param {string} name - enum name
+ * @return {boolean}
+ * */
+function isEnumEager(name) {
+    var _a;
+    return ((_a = getEnum(name)) === null || _a === void 0 ? void 0 : _a.mode) === 'eager';
+}
+/**
+ * Check enum defined or not, by name
+ *
+ * @param {string} name - enum name
+ * @return {boolean}
+ * */
+function isEnumDefined(name) {
+    return !!getEnum(name);
+}
+/**
+ * Get enum by name
+ * Note:
+ * - Enum may be lazy mode, so it has lazy paths without data
+ *
+ * @param {string} name - enum name
+ * @return {EnumItem}
+ * */
+function getEnum(name) {
+    if (!(0, function_1.isText)(name)) {
+        return undefined;
+    }
+    if (!names.has(name)) {
+        return undefined;
+    }
+    return names.get(name);
+}
+/**
+ * Load lazy enum by name
+ * Note:
+ * - Enum must be exported as `foretell`
+ *
+ * @param {string} name - name of enum
+ * @return {Promise<EnumItem>}
+ * */
+function getLazyEnum(name) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!(0, function_1.isText)(name)) {
+            return undefined;
+        }
+        if (!names.has(name)) {
+            return undefined;
+        }
+        const item = names.get(name);
+        if (item.mode === 'eager') {
+            return item;
+        }
+        try {
+            item.data = yield item.lazyData;
+            if (item.data) {
+                if (isAlreadyDefined(name, item.data)) {
+                    delete item.lazyData;
+                    delete item.lazyAlt;
+                    return item;
+                }
+                item.data[const_1.LY_ENUM_NAME] = name;
+                item.mode = 'eager';
+                item.type = Array.isArray(item.data) ? 'literal' : 'map';
+            }
+        }
+        catch (e) {
+            new error_1.DeveloperError('Raised callback run', 'optCheck#01', where).log(e);
+        }
+        if (item.data && item.lazyAlt) {
+            try {
+                item.alt = yield item.lazyAlt;
+                delete item.lazyAlt;
+                if (item.alt) {
+                    item.data[const_1.LY_ENUM_ALT] = item.alt;
+                }
+            }
+            catch (e) {
+                new error_1.DeveloperError('Raised callback run', 'optCheck#01', where).log(e);
+            }
+        }
+        delete item.lazyData;
+        delete item.lazyAlt;
+        return item;
+    });
+}
+//# sourceMappingURL=enum.fn.js.map

package/dist/common/enum.fn.js.map

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

package/dist/common/error.fn.d.ts

@@ -0,0 +1,91 @@
+import { ClassLike, ErrorDefineEagerOpt, ErrorDefineLazyOpt, ErrorItem, LeyyoErrorLike, LeyyoStackLike, Opt } from "../index.types";
+/**
+ * Define an error
+ *
+ * @param {ClassLike} clazz - error class
+ * @param {ErrorDefineEagerOpt} options - options
+ * */
+export declare function defineError(clazz: ClassLike, options: ErrorDefineEagerOpt): void;
+/**
+ * Define an error as lazy (with path)
+ *
+ * @param {ErrorDefineLazyOpt} opt - error options
+ * */
+export declare function defineLazyError(opt: ErrorDefineLazyOpt): void;
+/**
+ * Check error defined as lazy, by name
+ * Note:
+ * - Error's mode will be shifted lazy to eager after loaded
+ *
+ * @param {string} name - error name
+ * @return {boolean}
+ * */
+export declare function isErrorLazy(name: string): boolean;
+/**
+ * Check error defined as eager, by name
+ *
+ * @param {string} name - error name
+ * @return {boolean}
+ * */
+export declare function isErrorEager(name: string): boolean;
+/**
+ * Check error defined or not, by name
+ *
+ * @param {string} name - error name
+ * @return {boolean}
+ * */
+export declare function isErrorDefined(name: string): boolean;
+/**
+ * Get error by name
+ * Note:
+ * - Enum may be lazy mode, so it has lazy paths without class
+ *
+ * @param {string} name - error name
+ * @return {EnumItem}
+ * */
+export declare function getError(name: string): ErrorItem;
+/**
+ * Load lazy error by name
+ * Note:
+ * - Error must be exported as `foretell`
+ *
+ * @param {string} name - name of error
+ * @return {Promise<EnumItem>}
+ * */
+export declare function getLazyError(name: string): Promise<ErrorItem>;
+/**
+ * It will be called when an error raised
+ * */
+export declare function emitError(err: Error): void;
+/**
+ * Build error stack
+ *
+ * @param {Error} source
+ * @param {boolean?} force
+ * */
+export declare function errorStack(source: LeyyoStackLike, force?: boolean): void;
+/**
+ * Transform error as a bare object without name and message
+ *
+ * @param {Error} err - error instance
+ * @param {Opt} existing - existing parameters
+ * @return {Opt?} - bare error object
+ * */
+export declare function toErrorJsonBasic(err: Error, existing?: Opt): Opt;
+/**
+ * Transform error as a bare object with name and message
+ *
+ * @param {Error} err - error instance
+ * @param {Opt} existing - existing parameters
+ * @return {Opt?} - bare error object
+ * */
+export declare function toErrorJsonFull(err: Error, existing: Opt): Opt;
+/**
+ * Cast a native error to given error class
+ *
+ * @param {function} clazz - new error class
+ * @param {Error} e - native error instance
+ * @param {Opt?} params - params for error
+ * @return {LeyyoErrorLike} - new error instance
+ * */
+export declare function errorCast<E extends LeyyoErrorLike>(clazz: ClassLike, e: Error, params?: Opt): E;