@aglyn/shared-util-tools 1.0.0-beta.143

package/src/lib/normalized.js

@@ -0,0 +1,232 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ // eslint-disable-next-line @nx/enforce-module-boundaries
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { arrayMoveAtIndex } from "./array/array-move-at-index.js";
+import { arrayRemoveItem } from "./array/array-remove-item.js";
+import { _isNum, _isObj } from "./guards/index.js";
+import { objectDeleteProperty } from "./object/object-delete-property.js";
+/**
+ * Normalized data for 3NF
+ *
+ * @export
+ * @abstract
+ * @class Normalized
+ * @extends {NormalizedData<T, K>}
+ * @template T
+ * @template K
+ * @see https://en.wikipedia.org/wiki/Third_normal_form
+ */ export class Normalized {
+    static build() {
+        return {
+            ids: [],
+            byId: {}
+        };
+    }
+    get length() {
+        var _this_ids;
+        return ((_this_ids = this.ids) != null ? _this_ids : []).length;
+    }
+    /**
+   * Maps the ids/keys to their respective values in byId
+   *
+   * @static
+   * @template T
+   * @template V
+   * @param {T} v
+   * @returns {V[]}
+   * @memberof Normalized
+   */ static toArray(v) {
+        return Array.from(v.ids).map((id)=>v.byId[id]);
+    }
+    /**
+   * Resets the keys/ids and values/byId back to empty
+   *
+   * @static
+   * @param {NormalizedData} v
+   * @returns {NormalizedData}
+   * @memberof Normalized
+   */ static clear(v) {
+        v.ids = [];
+        v.byId = {};
+        return v;
+    }
+    /**
+   * Clears all values
+   * @returns {this}
+   * @memberof Normalized
+   */ clear() {
+        return Normalized.clear(this);
+    }
+    /**
+   * Create a new class instance from the provided params
+   *
+   * @static
+   * @template T
+   * @template K
+   * @param {(...T[] | [id: K, value: any][])} items
+   * @returns {NormalizedModel<T>}
+   * @memberof Normalized
+   */ static from(...items) {
+        const _items = [
+            ...items
+        ].map((i)=>_isObj(i) ? [
+                i['id'],
+                i
+            ] : [
+                ...i
+            ]);
+        const parsed = _items.reduce((acc, [id, v])=>{
+            var _ref;
+            return {
+                ids: ((_ref = acc == null ? void 0 : acc.ids) != null ? _ref : []).concat(id),
+                byId: _extends({}, acc == null ? void 0 : acc.byId, {
+                    [id]: v
+                })
+            };
+        }, {
+            ids: [],
+            byId: {}
+        });
+        return new this(parsed);
+    }
+    /**
+   * Removes an item from an existing key value data structure object
+   *
+   * @static
+   * @template T
+   * @param {ID} id
+   * @param {NormalizedData<T>} model
+   * @returns {NormalizedData<T>}
+   * @memberof Normalized
+   */ static remove(id, model) {
+        model.ids = arrayRemoveItem(model.ids, id);
+        model.byId = objectDeleteProperty(model.byId, id);
+        return model;
+    }
+    /**
+   * Sets an item in an existing denormalized key value object.
+   *
+   * @static
+   * @template T
+   * @template V
+   * @template K
+   * @param {[id: K, value: V]} item
+   * @param {T} model
+   * @param {number} [index]
+   * @returns {T}
+   * @memberof Normalized
+   */ static set(item, model, index) {
+        const [id, value] = item;
+        const currentIndex = model.ids.indexOf(id);
+        const isUpdate = currentIndex !== -1;
+        model.byId[id] = value;
+        if (!isUpdate) {
+            model.ids.push(id);
+        } else if (_isNum(index) && currentIndex !== index) {
+            model.ids = arrayMoveAtIndex(model.ids, currentIndex, index);
+        }
+        return model;
+    }
+    /**
+   * Get a property from the key value. shortens call such as model.byId[foo]
+   *
+   * @static
+   * @template T
+   * @param {ID} id
+   * @param {NormalizedData<T>} model
+   * @returns {(undefined | T)}
+   * @memberof Normalized
+   */ static get(id, model) {
+        var _model_byId_id;
+        return (_model_byId_id = model.byId[id]) != null ? _model_byId_id : null;
+    }
+    /**
+   * The properties to keep when object is passed to JSON.stringify(...)
+   * @returns {NormalizedData<T, K>}
+   * @memberof Normalized
+   */ toJSON() {
+        return {
+            ids: this.ids,
+            byId: this.byId
+        };
+    }
+    /**
+   * Converts the current values into an array ordered by the
+   * appearance of the key in ids array
+   * @returns {Array<T>}
+   * @memberof Normalized
+   */ toArray() {
+        return Normalized.toArray(this);
+    }
+    /**
+   * Aliases the static method to shortcut delete operations on this instance
+   *
+   * @param {K} id
+   * @returns {this}
+   * @memberof Normalized
+   */ remove(id) {
+        Normalized.remove(id, this);
+        return this;
+    }
+    /**
+   * Returns whether or not the model byId has property key/id
+   *
+   * @param {ID} id
+   * @returns {boolean}
+   * @memberof Normalized
+   */ has(id) {
+        return this.hasOwnProperty.call(this.byId, id);
+    }
+    /**
+   * Aliases the static method to shortcut set operations on this instance
+   *
+   * @param {ID} id
+   * @param {*} [value]
+   * @param {number} [index]
+   * @returns {this}
+   * @memberof Normalized
+   */ set(id, value, index) {
+        return Normalized.set([
+            id,
+            value
+        ], this, index);
+    }
+    /**
+   * Shortcuts getting the value of properties of the current instance
+   *
+   * @param {ID} id
+   * @returns {(undefined | T)}
+   * @memberof Normalized
+   */ get(id) {
+        return Normalized.get(id, this);
+    }
+    /** @ignore */ get hasOwnProperty() {
+        return Object.prototype.hasOwnProperty;
+    }
+    constructor(props){
+        this.props = props;
+        this.ids = [];
+        this.byId = {};
+        const { ids, byId } = _extends({}, props);
+        this.ids = [
+            ...ids != null ? ids : []
+        ];
+        this.byId = _extends({}, byId);
+    }
+}
+
+//# sourceMappingURL=normalized.js.map

package/src/lib/normalized.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/shared/util/tools/src/lib/normalized.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// eslint-disable-next-line @nx/enforce-module-boundaries\nimport { NormalizedData, NormalizedModel } from '@aglyn/shared-data-types'\nimport { arrayMoveAtIndex } from './array/array-move-at-index'\nimport { arrayRemoveItem } from './array/array-remove-item'\nimport { _isNum, _isObj } from './guards'\nimport { objectDeleteProperty } from './object/object-delete-property'\n\n\ntype ID = string\n\n/**\n * Normalized data for 3NF\n *\n * @export\n * @abstract\n * @class Normalized\n * @extends {NormalizedData<T, K>}\n * @template T\n * @template K\n * @see https://en.wikipedia.org/wiki/Third_normal_form\n */\nexport class Normalized<T = any, K extends ID = ID>\n  implements NormalizedModel<T, K>\n{\n  static build<T, K extends ID>(): NormalizedData<T, K> {\n    return { ids: [], byId: {} }\n  }\n\n  public ids: K[] = []\n  public byId: { [P in K]?: T } = {}\n\n  public get length(): number {\n    return (this.ids ?? []).length\n  }\n\n  constructor(public readonly props?: NormalizedData<T, K>) {\n    const { ids, byId } = { ...props }\n    this.ids = [...(ids ?? [])]\n    this.byId = { ...byId }\n  }\n\n  /**\n   * Maps the ids/keys to their respective values in byId\n   *\n   * @static\n   * @template T\n   * @template V\n   * @param {T} v\n   * @returns {V[]}\n   * @memberof Normalized\n   */\n  public static toArray<T extends NormalizedData<V>, V>(v: T): V[] {\n    return Array.from(v.ids).map((id) => v.byId[id])\n  }\n\n  /**\n   * Resets the keys/ids and values/byId back to empty\n   *\n   * @static\n   * @param {NormalizedData} v\n   * @returns {NormalizedData}\n   * @memberof Normalized\n   */\n  public static clear<T extends NormalizedData<any>>(v: T): T {\n    v.ids = []\n    v.byId = {}\n    return v\n  }\n\n  /**\n   * Clears all values\n   * @returns {this}\n   * @memberof Normalized\n   */\n  public clear(): this {\n    return Normalized.clear(this)\n  }\n\n  /**\n   * Create a new class instance from the provided params\n   *\n   * @static\n   * @template T\n   * @template K\n   * @param {(...T[] | [id: K, value: any][])} items\n   * @returns {NormalizedModel<T>}\n   * @memberof Normalized\n   */\n  public static from<T extends { id: ID }, K extends ID>(\n    ...items: T[] | [id: K, value: any][]\n  ): NormalizedModel<T> {\n    const _items = [...items].map((i) => (_isObj(i) ? [i['id'], i] : [...i]))\n    const parsed = _items.reduce<NormalizedData<T, K>>(\n      (acc, [id, v]) => ({\n        ids: (acc?.ids ?? []).concat(id),\n        byId: { ...acc?.byId, [id]: v },\n      }),\n      { ids: [], byId: {} },\n    )\n    return new this(parsed)\n  }\n\n  /**\n   * Removes an item from an existing key value data structure object\n   *\n   * @static\n   * @template T\n   * @param {ID} id\n   * @param {NormalizedData<T>} model\n   * @returns {NormalizedData<T>}\n   * @memberof Normalized\n   */\n  public static remove<\n    T extends NormalizedData<TT, any>,\n    K extends ID,\n    TT = any,\n  >(id: K, model: T): NormalizedData<TT, ID> {\n    model.ids = arrayRemoveItem(model.ids, id)\n    model.byId = objectDeleteProperty(model.byId, id)\n    return model\n  }\n\n  /**\n   * Sets an item in an existing denormalized key value object.\n   *\n   * @static\n   * @template T\n   * @template V\n   * @template K\n   * @param {[id: K, value: V]} item\n   * @param {T} model\n   * @param {number} [index]\n   * @returns {T}\n   * @memberof Normalized\n   */\n  public static set<T extends NormalizedData<V, K>, V, K extends ID>(\n    item: [id: K, value: V],\n    model: T,\n    index?: number,\n  ): T {\n    const [id, value] = item\n    const currentIndex = model.ids.indexOf(id)\n    const isUpdate = currentIndex !== -1\n\n    model.byId[id] = value\n\n    if (!isUpdate) {\n      model.ids.push(id)\n    } else if (_isNum(index) && currentIndex !== index) {\n      model.ids = arrayMoveAtIndex(model.ids, currentIndex, index)\n    }\n\n    return model\n  }\n\n  /**\n   * Get a property from the key value. shortens call such as model.byId[foo]\n   *\n   * @static\n   * @template T\n   * @param {ID} id\n   * @param {NormalizedData<T>} model\n   * @returns {(undefined | T)}\n   * @memberof Normalized\n   */\n  public static get<T extends NormalizedData<V, K>, K extends ID, V>(\n    id: K,\n    model: T,\n  ): V | null {\n    return model.byId[id] ?? null\n  }\n\n  /**\n   * The properties to keep when object is passed to JSON.stringify(...)\n   * @returns {NormalizedData<T, K>}\n   * @memberof Normalized\n   */\n  public toJSON(): NormalizedData<T, K> {\n    return { ids: this.ids, byId: this.byId }\n  }\n\n  /**\n   * Converts the current values into an array ordered by the\n   * appearance of the key in ids array\n   * @returns {Array<T>}\n   * @memberof Normalized\n   */\n  public toArray(): Array<T> {\n    return Normalized.toArray(this)\n  }\n\n  /**\n   * Aliases the static method to shortcut delete operations on this instance\n   *\n   * @param {K} id\n   * @returns {this}\n   * @memberof Normalized\n   */\n  public remove(id: K): this {\n    Normalized.remove(id, this)\n    return this\n  }\n\n  /**\n   * Returns whether or not the model byId has property key/id\n   *\n   * @param {ID} id\n   * @returns {boolean}\n   * @memberof Normalized\n   */\n  public has(id: ID): boolean {\n    return this.hasOwnProperty.call(this.byId, id)\n  }\n\n  /**\n   * Aliases the static method to shortcut set operations on this instance\n   *\n   * @param {ID} id\n   * @param {*} [value]\n   * @param {number} [index]\n   * @returns {this}\n   * @memberof Normalized\n   */\n  public set(id: ID, value?: T, index?: number): this {\n    return Normalized.set([id, value], this, index)\n  }\n\n  /**\n   * Shortcuts getting the value of properties of the current instance\n   *\n   * @param {ID} id\n   * @returns {(undefined | T)}\n   * @memberof Normalized\n   */\n  public get(id: ID): undefined | T {\n    return Normalized.get(id, this)\n  }\n\n  /** @ignore */\n  private get hasOwnProperty() {\n    return Object.prototype.hasOwnProperty\n  }\n}\n"],"names":["arrayMoveAtIndex","arrayRemoveItem","_isNum","_isObj","objectDeleteProperty","Normalized","build","ids","byId","length","toArray","v","Array","from","map","id","clear","items","_items","i","parsed","reduce","acc","concat","remove","model","set","item","index","value","currentIndex","indexOf","isUpdate","push","get","toJSON","has","hasOwnProperty","call","Object","prototype","props"],"mappings":"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"}

package/src/lib/number/number-from-hexadecimal.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Convert Base16/Hexadecimal string to its decimal/number equivalent
+ *
+ * @param hex - 8-bit hexadecimal string
+ * @returns the hexadecimal as a number
+ */
+export declare function numberFromHexadecimal(hex: string): number;
+export default numberFromHexadecimal;

package/src/lib/number/number-from-hexadecimal.js

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { toNum } from "./to-num.js";
+/**
+ * Convert Base16/Hexadecimal string to its decimal/number equivalent
+ *
+ * @param hex - 8-bit hexadecimal string
+ * @returns the hexadecimal as a number
+ */ export function numberFromHexadecimal(hex) {
+    return toNum(hex, {
+        radix: 16
+    });
+}
+export default numberFromHexadecimal;
+
+//# sourceMappingURL=number-from-hexadecimal.js.map

package/src/lib/number/number-from-hexadecimal.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/number/number-from-hexadecimal.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {toNum} from './to-num'\n\n\n/**\n * Convert Base16/Hexadecimal string to its decimal/number equivalent\n *\n * @param hex - 8-bit hexadecimal string\n * @returns the hexadecimal as a number\n */\nexport function numberFromHexadecimal(hex: string): number {\n  return toNum(hex, {radix: 16})\n}\nexport default numberFromHexadecimal\n"],"names":["toNum","numberFromHexadecimal","hex","radix"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAAQA,KAAK,QAAO,cAAU;AAG9B;;;;;CAKC,GACD,OAAO,SAASC,sBAAsBC,GAAW;IAC/C,OAAOF,MAAME,KAAK;QAACC,OAAO;IAAE;AAC9B;AACA,eAAeF,sBAAqB"}

package/src/lib/number/number-to-hexadecimal.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Convert any value to 8-bit hexadecimal string
+ * @param val - value to convert
+ */
+export declare function numberToHexadecimal<T>(val: T): string;
+export default numberToHexadecimal;

package/src/lib/number/number-to-hexadecimal.js

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * Convert any value to 8-bit hexadecimal string
+ * @param val - value to convert
+ */ export function numberToHexadecimal(val) {
+    return Number(val).toString(16);
+}
+export default numberToHexadecimal;
+
+//# sourceMappingURL=number-to-hexadecimal.js.map

package/src/lib/number/number-to-hexadecimal.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/number/number-to-hexadecimal.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Convert any value to 8-bit hexadecimal string\n * @param val - value to convert\n */\nexport function numberToHexadecimal<T>(val: T): string {\n  return Number(val).toString(16)\n}\nexport default numberToHexadecimal\n"],"names":["numberToHexadecimal","val","Number","toString"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;CAGC,GACD,OAAO,SAASA,oBAAuBC,GAAM;IAC3C,OAAOC,OAAOD,KAAKE,QAAQ,CAAC;AAC9B;AACA,eAAeH,oBAAmB"}

package/src/lib/number/to-num.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2023 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+type ToNumType = 'int' | 'float' | 'eval';
+type ToNumResult<T extends ToNumType = never> = ConditionalNonDist<T, 'eval', any, number>;
+export type ToNumOptions<T extends ToNumType = never, N = 0> = {
+    onNaN?: N;
+    type?: 'int';
+    radix?: number;
+} | {
+    onNaN?: N;
+    type?: T;
+    radix?: never;
+};
+/**
+ * Ensure and parse any value to a number.
+ *
+ * - If radix, `{type: 'int'}` is provided will use {@link parseInt}
+ * - If `{type: 'parse'}` is provided will use {@link parseFloat}
+ * - If `{type: 'eval'}` is provided will use {@link eval} and {@link Number}
+ * - Otherwise uses {@link Number|Number(val)}
+ * - If parsing results in NaN will return {@link onNaN}.
+ *
+ * @param val - the value to parse into a number
+ * @param options - override default parsing behavior
+ */
+export declare function toNum<T extends ToNumType, N = 0>(val: string | any, options?: ToNumOptions<T, N>): ToNumResult<T> | N;
+export {};

package/src/lib/number/to-num.js

@@ -0,0 +1,41 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2023 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { _isNumT } from "../guards/lib/_is-num-t.js";
+/**
+ * Ensure and parse any value to a number.
+ *
+ * - If radix, `{type: 'int'}` is provided will use {@link parseInt}
+ * - If `{type: 'parse'}` is provided will use {@link parseFloat}
+ * - If `{type: 'eval'}` is provided will use {@link eval} and {@link Number}
+ * - Otherwise uses {@link Number|Number(val)}
+ * - If parsing results in NaN will return {@link onNaN}.
+ *
+ * @param val - the value to parse into a number
+ * @param options - override default parsing behavior
+ */ export function toNum(val, options) {
+    const { type, onNaN, radix } = _extends({}, options);
+    let parsed = NaN;
+    if (_isNumT(radix)) parsed = parseInt(val, radix);
+    else if (type === 'int') parsed = parseInt(val);
+    else if (type === 'float') parsed = parseFloat(val);
+    else if (type === 'eval') parsed = Number(eval(val));
+    else if (!type) parsed = Number(val);
+    if (isNaN(parsed)) parsed = onNaN != null ? onNaN : 0;
+    return parsed;
+}
+
+//# sourceMappingURL=to-num.js.map

package/src/lib/number/to-num.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/number/to-num.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2023 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { _isNumT } from '../guards/lib/_is-num-t'\n\ntype ToNumType = 'int' | 'float' | 'eval'\ntype ToNumResult<T extends ToNumType = never> = ConditionalNonDist<\n  T,\n  'eval',\n  any,\n  number\n>\n\nexport type ToNumOptions<T extends ToNumType = never, N = 0> =\n  | { onNaN?: N; type?: 'int'; radix?: number }\n  | { onNaN?: N; type?: T; radix?: never }\n\n/**\n * Ensure and parse any value to a number.\n *\n * - If radix, `{type: 'int'}` is provided will use {@link parseInt}\n * - If `{type: 'parse'}` is provided will use {@link parseFloat}\n * - If `{type: 'eval'}` is provided will use {@link eval} and {@link Number}\n * - Otherwise uses {@link Number|Number(val)}\n * - If parsing results in NaN will return {@link onNaN}.\n *\n * @param val - the value to parse into a number\n * @param options - override default parsing behavior\n */\nexport function toNum<T extends ToNumType, N = 0>(\n  val: string | any,\n  options?: ToNumOptions<T, N>,\n): ToNumResult<T> | N {\n  const { type, onNaN, radix } = { ...options }\n  let parsed: ToNumResult<T> | N = NaN\n\n  if (_isNumT(radix)) parsed = parseInt(val, radix)\n  else if (type === 'int') parsed = parseInt(val)\n  else if (type === 'float') parsed = parseFloat(val)\n  else if (type === 'eval') parsed = Number(eval(val))\n  else if (!type) parsed = Number(val)\n  if (isNaN(parsed)) parsed = onNaN ?? 0\n\n  return parsed\n}\n"],"names":["_isNumT","toNum","val","options","type","onNaN","radix","parsed","NaN","parseInt","parseFloat","Number","eval","isNaN"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,OAAO,QAAQ,6BAAyB;AAcjD;;;;;;;;;;;CAWC,GACD,OAAO,SAASC,MACdC,GAAiB,EACjBC,OAA4B;IAE5B,MAAM,EAAEC,IAAI,EAAEC,KAAK,EAAEC,KAAK,EAAE,GAAG,aAAKH;IACpC,IAAII,SAA6BC;IAEjC,IAAIR,QAAQM,QAAQC,SAASE,SAASP,KAAKI;SACtC,IAAIF,SAAS,OAAOG,SAASE,SAASP;SACtC,IAAIE,SAAS,SAASG,SAASG,WAAWR;SAC1C,IAAIE,SAAS,QAAQG,SAASI,OAAOC,KAAKV;SAC1C,IAAI,CAACE,MAAMG,SAASI,OAAOT;IAChC,IAAIW,MAAMN,SAASA,SAASF,gBAAAA,QAAS;IAErC,OAAOE;AACT"}

package/src/lib/numeronym.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2021 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export type NumeronymOpts = {
+    kind?: NumeronymKind;
+    short?: boolean;
+};
+export declare enum NumeronymKind {
+    n19s = "NumericalContractions",
+    A9bs = "AlphanumericAbbreviationS",
+    A2S = "AlphanumericAcronymS"
+}
+/**
+ * Create a numeronym string from the provided string of characters
+ *
+ * e.g.
+ * ```typescript
+ * const intl = 'Internationalization'
+ * numeronym(intl, {kind: NumeronymKind.n19s})
+ * // result: I18n
+ * ```
+ *
+ * @export
+ * @param {string} str
+ * @param {NumeronymOpts} [opt]
+ * @returns
+ */
+export declare function numeronym(str: string, opt?: NumeronymOpts): string;

package/src/lib/numeronym.js

@@ -0,0 +1,54 @@
+/**
+ * @license
+ * Copyright 2021 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ export var NumeronymKind = /*#__PURE__*/ function(NumeronymKind) {
+    NumeronymKind["n19s"] = "NumericalContractions"; /* first letter + len between(+ last letter) */ 
+    NumeronymKind["A9bs"] = "AlphanumericAbbreviationS"; /* AlphaN. = A9, Abbr. = bs */ 
+    NumeronymKind["A2S"] = "AlphanumericAcronymS"; /* (2) A's and (1) S (e.g. W3 or W3C) */ 
+    return NumeronymKind;
+}({});
+/**
+ * Create a numeronym string from the provided string of characters
+ *
+ * e.g.
+ * ```typescript
+ * const intl = 'Internationalization'
+ * numeronym(intl, {kind: NumeronymKind.n19s})
+ * // result: I18n
+ * ```
+ *
+ * @export
+ * @param {string} str
+ * @param {NumeronymOpts} [opt]
+ * @returns
+ */ export function numeronym(str, opt) {
+    const { kind, short } = opt != null ? opt : {};
+    const builder = {
+        ["NumericalContractions"]: ()=>{
+            const v = String(str);
+            const ln = v.length;
+            if (ln < 2) {
+                return v;
+            }
+            if (ln < 3 || short) {
+                return `${v[0]}${ln - 1}`;
+            }
+            return `${v[0]}${ln - 2}${v[ln - 1]}`;
+        }
+    };
+    return builder[kind != null ? kind : "NumericalContractions"]();
+}
+
+//# sourceMappingURL=numeronym.js.map

package/src/lib/numeronym.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/shared/util/tools/src/lib/numeronym.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2021 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n\n\nexport type NumeronymOpts = {\n  kind?: NumeronymKind\n  short?: boolean\n}\n\nexport enum NumeronymKind {\n  n19s = 'NumericalContractions' /* first letter + len between(+ last letter) */,\n  A9bs = 'AlphanumericAbbreviationS' /* AlphaN. = A9, Abbr. = bs */,\n  A2S = 'AlphanumericAcronymS' /* (2) A's and (1) S (e.g. W3 or W3C) */,\n}\n\n/**\n * Create a numeronym string from the provided string of characters\n *\n * e.g.\n * ```typescript\n * const intl = 'Internationalization'\n * numeronym(intl, {kind: NumeronymKind.n19s})\n * // result: I18n\n * ```\n *\n * @export\n * @param {string} str\n * @param {NumeronymOpts} [opt]\n * @returns\n */\nexport function numeronym(str: string, opt?: NumeronymOpts) {\n  const {kind, short} = opt ?? {}\n  const builder = {\n    [NumeronymKind.n19s]: () => {\n      const v = String(str)\n      const ln = v.length\n      if (ln < 2) {\n        return v\n      }\n      if (ln < 3 || short) {\n        return `${v[0]}${ln - 1}`\n      }\n      return `${v[0]}${ln - 2}${v[ln - 1]}`\n    },\n  }\n\n  return (builder as Record<string, () => string>)[kind ?? NumeronymKind.n19s]()\n}\n"],"names":["NumeronymKind","numeronym","str","opt","kind","short","builder","v","String","ln","length"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GASD,OAAO,IAAA,AAAKA,uCAAAA;qDACqB,6CAA6C;yDACzC,4BAA4B;mDAClC,sCAAsC;WAHzDA;MAIX;AAED;;;;;;;;;;;;;;CAcC,GACD,OAAO,SAASC,UAAUC,GAAW,EAAEC,GAAmB;IACxD,MAAM,EAACC,IAAI,EAAEC,KAAK,EAAC,GAAGF,cAAAA,MAAO,CAAC;IAC9B,MAAMG,UAAU;QACd,yBAAoB,EAAE;YACpB,MAAMC,IAAIC,OAAON;YACjB,MAAMO,KAAKF,EAAEG,MAAM;YACnB,IAAID,KAAK,GAAG;gBACV,OAAOF;YACT;YACA,IAAIE,KAAK,KAAKJ,OAAO;gBACnB,OAAO,GAAGE,CAAC,CAAC,EAAE,GAAGE,KAAK,GAAG;YAC3B;YACA,OAAO,GAAGF,CAAC,CAAC,EAAE,GAAGE,KAAK,IAAIF,CAAC,CAACE,KAAK,EAAE,EAAE;QACvC;IACF;IAEA,OAAO,AAACH,OAAwC,CAACF,eAAAA,+BAA2B;AAC9E"}

package/src/lib/object/object-clone-deep.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Copy deep
+ */
+export declare function objectCloneDeep<K extends keyof any, T>(target: Record<K, T>): Record<K, T>;
+export default objectCloneDeep;

package/src/lib/object/object-clone-deep.js

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import cloneDeep from "../copy.js";
+/**
+ * Copy deep
+ */ export function objectCloneDeep(target) {
+    return cloneDeep(target);
+}
+export default objectCloneDeep;
+
+//# sourceMappingURL=object-clone-deep.js.map

package/src/lib/object/object-clone-deep.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/object/object-clone-deep.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport cloneDeep from '../copy'\n\n/**\n * Copy deep\n */\nexport function objectCloneDeep<K extends keyof any, T>(\n  target: Record<K, T>,\n): Record<K, T> {\n  return cloneDeep(target)\n}\nexport default objectCloneDeep\n"],"names":["cloneDeep","objectCloneDeep","target"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,OAAOA,eAAe,aAAS;AAE/B;;CAEC,GACD,OAAO,SAASC,gBACdC,MAAoB;IAEpB,OAAOF,UAAUE;AACnB;AACA,eAAeD,gBAAe"}

package/src/lib/object/object-clone.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Shallow copy iterable properties in iterable or array
+ */
+export declare function objectClone<T>(target: Record<keyof any, T>): Record<keyof any, T>;
+export default objectClone;

package/src/lib/object/object-clone.js

@@ -0,0 +1,24 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * Shallow copy iterable properties in iterable or array
+ */ export function objectClone(target) {
+    return _extends({}, target);
+}
+export default objectClone;
+
+//# sourceMappingURL=object-clone.js.map