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

package/src/lib/array/array-from.js

@@ -0,0 +1,26 @@
+/**
+ * @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.
+ */ /**
+ * Shallow copy iterable or array like
+ * @param iterable - An iterable object to convert to an array.
+ * @param callbackFn - A mapping function to call on every element of the array.
+ * @param thisArg - Value of 'this' used to invoke the callbackFn
+ */ export function arrayFrom(iterable, callbackFn, thisArg) {
+    return Array.from(iterable, callbackFn, thisArg);
+}
+export default arrayFrom;
+
+//# sourceMappingURL=array-from.js.map

package/src/lib/array/array-from.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/array/array-from.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/**\n * Shallow copy iterable or array like\n * @param iterable - An iterable object to convert to an array.\n * @param callbackFn - A mapping function to call on every element of the array.\n * @param thisArg - Value of 'this' used to invoke the callbackFn\n */\nexport function arrayFrom<T, U>(\n  iterable: Iterable<T> | ArrayLike<T>,\n  callbackFn: (v: T, k: number) => U,\n  thisArg?: any,\n): U[] {\n  return Array.from(iterable, callbackFn, thisArg)\n}\nexport default arrayFrom\n"],"names":["arrayFrom","iterable","callbackFn","thisArg","Array","from"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;CAKC,GACD,OAAO,SAASA,UACdC,QAAoC,EACpCC,UAAkC,EAClCC,OAAa;IAEb,OAAOC,MAAMC,IAAI,CAACJ,UAAUC,YAAYC;AAC1C;AACA,eAAeH,UAAS"}

package/src/lib/array/array-move-at-index.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.
+ */
+/**
+ * Move an element in the array
+ * @param array - The array to mutate and reorder
+ * @param index - Current index of the item to move
+ * @param newIndex - New index for the item to be moved to
+ */
+export declare function arrayMoveAtIndex<K extends number & keyof T, T extends Array<U>, U>(array: T, index: K | any, newIndex: K | any): T;
+export default arrayMoveAtIndex;

package/src/lib/array/array-move-at-index.js

@@ -0,0 +1,32 @@
+/**
+ * @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.
+ */ /**
+ * Move an element in the array
+ * @param array - The array to mutate and reorder
+ * @param index - Current index of the item to move
+ * @param newIndex - New index for the item to be moved to
+ */ export function arrayMoveAtIndex(array, index, newIndex) {
+    if (!Array.isArray(array)) {
+        throw new TypeError(`arrayMoveAtIndex: expected an array but received ${array === null ? 'null' : typeof array}`);
+    }
+    const item = array.splice(index, 1)[0];
+    if (isNaN(newIndex)) array.push(item);
+    else array.splice(newIndex, 0, item);
+    return array;
+}
+export default arrayMoveAtIndex;
+
+//# sourceMappingURL=array-move-at-index.js.map

package/src/lib/array/array-move-at-index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/array/array-move-at-index.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/**\n * Move an element in the array\n * @param array - The array to mutate and reorder\n * @param index - Current index of the item to move\n * @param newIndex - New index for the item to be moved to\n */\nexport function arrayMoveAtIndex<K extends number & keyof T, T extends Array<U>, U>(\n  array: T,\n  index: K | any,\n  newIndex: K | any,\n): T {\n  if (!Array.isArray(array)) {\n    throw new TypeError(\n      `arrayMoveAtIndex: expected an array but received ${array === null ? 'null' : typeof array}`,\n    )\n  }\n  const item = array.splice(index, 1)[0]\n  if (isNaN(newIndex)) array.push(item)\n  else array.splice(newIndex, 0, item)\n  return array\n}\nexport default arrayMoveAtIndex\n"],"names":["arrayMoveAtIndex","array","index","newIndex","Array","isArray","TypeError","item","splice","isNaN","push"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAGD;;;;;CAKC,GACD,OAAO,SAASA,iBACdC,KAAQ,EACRC,KAAc,EACdC,QAAiB;IAEjB,IAAI,CAACC,MAAMC,OAAO,CAACJ,QAAQ;QACzB,MAAM,IAAIK,UACR,CAAC,iDAAiD,EAAEL,UAAU,OAAO,SAAS,OAAOA,OAAO;IAEhG;IACA,MAAMM,OAAON,MAAMO,MAAM,CAACN,OAAO,EAAE,CAAC,EAAE;IACtC,IAAIO,MAAMN,WAAWF,MAAMS,IAAI,CAACH;SAC3BN,MAAMO,MAAM,CAACL,UAAU,GAAGI;IAC/B,OAAON;AACT;AACA,eAAeD,iBAAgB"}

package/src/lib/array/array-of-entries-to-object.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @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.
+ */
+export type ArrayEntriesIndex<K extends keyof any, V> = [key: K, value: V];
+/**
+ * Create KeyValueMap from an array of tuple with key and value
+ * @param entries - Array of tuples 0:key, 1:val to map into a new object
+ */
+export declare function arrayOfEntriesToObject<K extends keyof any, V>(entries: ArrayEntriesIndex<K, V>[]): Record<K, V>;
+export default arrayOfEntriesToObject;

package/src/lib/array/array-of-entries-to-object.js

@@ -0,0 +1,26 @@
+/**
+ * @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.
+ */ /**
+ * Create KeyValueMap from an array of tuple with key and value
+ * @param entries - Array of tuples 0:key, 1:val to map into a new object
+ */ export function arrayOfEntriesToObject(entries) {
+    return Object.assign({}, ...entries.map(([key, val])=>({
+            [key]: val
+        })));
+}
+export default arrayOfEntriesToObject;
+
+//# sourceMappingURL=array-of-entries-to-object.js.map

package/src/lib/array/array-of-entries-to-object.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/array/array-of-entries-to-object.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\nexport type ArrayEntriesIndex<K extends keyof any, V> = [key: K, value: V]\n\n/**\n * Create KeyValueMap from an array of tuple with key and value\n * @param entries - Array of tuples 0:key, 1:val to map into a new object\n */\nexport function arrayOfEntriesToObject<K extends keyof any, V>(\n  entries: ArrayEntriesIndex<K, V>[],\n): Record<K, V> {\n  return Object.assign({}, ...entries.map(([key, val]) => ({[key]: val})))\n}\nexport default arrayOfEntriesToObject\n"],"names":["arrayOfEntriesToObject","entries","Object","assign","map","key","val"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAKD;;;CAGC,GACD,OAAO,SAASA,uBACdC,OAAkC;IAElC,OAAOC,OAAOC,MAAM,CAAC,CAAC,MAAMF,QAAQG,GAAG,CAAC,CAAC,CAACC,KAAKC,IAAI,GAAM,CAAA;YAAC,CAACD,IAAI,EAAEC;QAAG,CAAA;AACtE;AACA,eAAeN,uBAAsB"}

package/src/lib/array/array-overrides.d.ts

@@ -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.
+ */
+declare global {
+    interface Array<T> {
+        $_cloneShallow(): Array<T>;
+        $_cloneDeep(): Array<T>;
+        $_moveAtIndex(index: number, newIndex: number): Array<T>;
+        $_pushAtIndex(index: number, newIndex: number): Array<T>;
+        $_removeItem(elem: T): Array<T>;
+        $_removeAtIndex(index: number): Array<T>;
+        $_replaceAtIndex(index: number, elem: T): Array<T>;
+        $_truthy(): Array<T>;
+    }
+}
+export {};

package/src/lib/array/array-overrides.js

@@ -0,0 +1,71 @@
+/**
+ * @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 arrayCopyDeep from "./array-copy-deep.js";
+import arrayCopyShallow from "./array-copy-shallow.js";
+import arrayMoveAtIndex from "./array-move-at-index.js";
+import arrayPushAtIndex from "./array-push-at-index.js";
+import arrayRemoveAtIndex from "./array-remove-at-index.js";
+import arrayRemoveItem from "./array-remove-item.js";
+import arrayUpdateAtIndex from "./array-update-at-index.js";
+/**
+ * Define all custom Array prototype methods with `enumerable: false`.
+ *
+ * WHY: Simple property assignment (`Array.prototype.foo = fn`) creates an ENUMERABLE property.
+ * MUI's `styleFunctionSx` iterates sx array objects with `for...in`, which walks the entire
+ * prototype chain and picks up any enumerable inherited properties — including our custom methods.
+ * It then calls them via `callIfFn(fn, theme)` WITHOUT a receiver, making `this === undefined`
+ * (strict-mode ES modules), which caused "arrayMoveAtIndex: expected an array but received undefined".
+ *
+ * Using `Object.defineProperty` with `enumerable: false` makes the methods invisible to
+ * `for...in`, `Object.keys`, and `JSON.stringify` while still accessible via direct calls
+ * and prototype chain lookups.
+ *
+ * ALSO: No guard (`if (!Array.prototype.$_xxx)`) so that Turbopack HMR re-evaluations always
+ * re-register the methods with fresh module bindings.
+ */ function defineArrayMethod(name, fn) {
+    Object.defineProperty(Array.prototype, name, {
+        value: fn,
+        enumerable: false,
+        writable: true,
+        configurable: true
+    });
+}
+defineArrayMethod('$_cloneShallow', function() {
+    return arrayCopyShallow(this);
+});
+defineArrayMethod('$_cloneDeep', function() {
+    return arrayCopyDeep(this);
+});
+defineArrayMethod('$_moveAtIndex', function(index, newIndex) {
+    return arrayMoveAtIndex(this, index, newIndex);
+});
+defineArrayMethod('$_pushAtIndex', function(index, ...elems) {
+    return arrayPushAtIndex(this, index, ...elems);
+});
+defineArrayMethod('$_removeItem', function(elem) {
+    return arrayRemoveItem(this, elem);
+});
+defineArrayMethod('$_removeAtIndex', function(index) {
+    return arrayRemoveAtIndex(this, index);
+});
+defineArrayMethod('$_replaceAtIndex', function(index, elem) {
+    return arrayUpdateAtIndex(this, index, elem);
+});
+defineArrayMethod('$_truthy', function() {
+    return this.filter(Boolean);
+});
+
+//# sourceMappingURL=array-overrides.js.map

package/src/lib/array/array-overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/array/array-overrides.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 arrayCopyDeep from './array-copy-deep'\nimport arrayCopyShallow from './array-copy-shallow'\nimport arrayMoveAtIndex from './array-move-at-index'\nimport arrayPushAtIndex from './array-push-at-index'\nimport arrayRemoveAtIndex from './array-remove-at-index'\nimport arrayRemoveItem from './array-remove-item'\nimport arrayUpdateAtIndex from './array-update-at-index'\n\ndeclare global {\n  interface Array<T> {\n    $_cloneShallow(): Array<T>\n    $_cloneDeep(): Array<T>\n    $_moveAtIndex(index: number, newIndex: number): Array<T>\n    $_pushAtIndex(index: number, newIndex: number): Array<T>\n    $_removeItem(elem: T): Array<T>\n    $_removeAtIndex(index: number): Array<T>\n    $_replaceAtIndex(index: number, elem: T): Array<T>\n    $_truthy(): Array<T>\n  }\n}\n\nexport {}\n\n/**\n * Define all custom Array prototype methods with `enumerable: false`.\n *\n * WHY: Simple property assignment (`Array.prototype.foo = fn`) creates an ENUMERABLE property.\n * MUI's `styleFunctionSx` iterates sx array objects with `for...in`, which walks the entire\n * prototype chain and picks up any enumerable inherited properties — including our custom methods.\n * It then calls them via `callIfFn(fn, theme)` WITHOUT a receiver, making `this === undefined`\n * (strict-mode ES modules), which caused \"arrayMoveAtIndex: expected an array but received undefined\".\n *\n * Using `Object.defineProperty` with `enumerable: false` makes the methods invisible to\n * `for...in`, `Object.keys`, and `JSON.stringify` while still accessible via direct calls\n * and prototype chain lookups.\n *\n * ALSO: No guard (`if (!Array.prototype.$_xxx)`) so that Turbopack HMR re-evaluations always\n * re-register the methods with fresh module bindings.\n */\nfunction defineArrayMethod(name: string, fn: (...args: any[]) => any): void {\n  Object.defineProperty(Array.prototype, name, {\n    value: fn,\n    enumerable: false,   // ← invisible to for...in (fixes the MUI sx iteration bug)\n    writable: true,\n    configurable: true,  // ← allows HMR re-evaluation to overwrite\n  })\n}\n\ndefineArrayMethod('$_cloneShallow', function <T>(this: Array<T>): Array<T> {\n  return arrayCopyShallow(this)\n})\n\ndefineArrayMethod('$_cloneDeep', function <T>(this: Array<T>): Array<T> {\n  return arrayCopyDeep(this)\n})\n\ndefineArrayMethod('$_moveAtIndex', function <T>(\n  this: Array<T>,\n  index: number,\n  newIndex: number,\n): Array<T> {\n  return arrayMoveAtIndex(this, index, newIndex)\n})\n\ndefineArrayMethod('$_pushAtIndex', function <T>(\n  this: Array<T>,\n  index: number,\n  ...elems: Array<T>\n): Array<T> {\n  return arrayPushAtIndex(this, index, ...elems)\n})\n\ndefineArrayMethod('$_removeItem', function <T>(this: Array<T>, elem: T): Array<T> {\n  return arrayRemoveItem(this, elem)\n})\n\ndefineArrayMethod('$_removeAtIndex', function <T>(this: Array<T>, index: number): Array<T> {\n  return arrayRemoveAtIndex(this, index)\n})\n\ndefineArrayMethod('$_replaceAtIndex', function <T>(\n  this: Array<T>,\n  index: number,\n  elem: T,\n): Array<T> {\n  return arrayUpdateAtIndex(this, index, elem)\n})\n\ndefineArrayMethod('$_truthy', function <T>(this: Array<T>): Array<T> {\n  return this.filter(Boolean)\n})\n"],"names":["arrayCopyDeep","arrayCopyShallow","arrayMoveAtIndex","arrayPushAtIndex","arrayRemoveAtIndex","arrayRemoveItem","arrayUpdateAtIndex","defineArrayMethod","name","fn","Object","defineProperty","Array","prototype","value","enumerable","writable","configurable","index","newIndex","elems","elem","filter","Boolean"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,OAAOA,mBAAmB,uBAAmB;AAC7C,OAAOC,sBAAsB,0BAAsB;AACnD,OAAOC,sBAAsB,2BAAuB;AACpD,OAAOC,sBAAsB,2BAAuB;AACpD,OAAOC,wBAAwB,6BAAyB;AACxD,OAAOC,qBAAqB,yBAAqB;AACjD,OAAOC,wBAAwB,6BAAyB;AAiBxD;;;;;;;;;;;;;;;CAeC,GACD,SAASC,kBAAkBC,IAAY,EAAEC,EAA2B;IAClEC,OAAOC,cAAc,CAACC,MAAMC,SAAS,EAAEL,MAAM;QAC3CM,OAAOL;QACPM,YAAY;QACZC,UAAU;QACVC,cAAc;IAChB;AACF;AAEAV,kBAAkB,kBAAkB;IAClC,OAAON,iBAAiB,IAAI;AAC9B;AAEAM,kBAAkB,eAAe;IAC/B,OAAOP,cAAc,IAAI;AAC3B;AAEAO,kBAAkB,iBAAiB,SAEjCW,KAAa,EACbC,QAAgB;IAEhB,OAAOjB,iBAAiB,IAAI,EAAEgB,OAAOC;AACvC;AAEAZ,kBAAkB,iBAAiB,SAEjCW,KAAa,EACb,GAAGE,KAAe;IAElB,OAAOjB,iBAAiB,IAAI,EAAEe,UAAUE;AAC1C;AAEAb,kBAAkB,gBAAgB,SAA6Bc,IAAO;IACpE,OAAOhB,gBAAgB,IAAI,EAAEgB;AAC/B;AAEAd,kBAAkB,mBAAmB,SAA6BW,KAAa;IAC7E,OAAOd,mBAAmB,IAAI,EAAEc;AAClC;AAEAX,kBAAkB,oBAAoB,SAEpCW,KAAa,EACbG,IAAO;IAEP,OAAOf,mBAAmB,IAAI,EAAEY,OAAOG;AACzC;AAEAd,kBAAkB,YAAY;IAC5B,OAAO,IAAI,CAACe,MAAM,CAACC;AACrB"}

package/src/lib/array/array-push-at-index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @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.
+ */
+/**
+ * Mutates the existing array by adding new items onto the array at the provided
+ * zero-based index. When the index is NaN, new items will be pushed onto the end
+ * of the array. When the index is greater than or equal to 0, new items will be
+ * pushed to the that index while any existing items previously located at or
+ * following the index will be shifted to right. Returns the mutated array.
+ * @param array - The array to mutate and push the new nodes onto
+ * @param index - The zero index to start the new nodes.
+ * @param items - New items to push onto the array
+ */
+export declare function arrayPushAtIndex<T>(array: Array<T>, index: number, ...items: T[]): Array<T>;
+export default arrayPushAtIndex;

package/src/lib/array/array-push-at-index.js

@@ -0,0 +1,32 @@
+/**
+ * @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.
+ */ /**
+ * Mutates the existing array by adding new items onto the array at the provided
+ * zero-based index. When the index is NaN, new items will be pushed onto the end
+ * of the array. When the index is greater than or equal to 0, new items will be
+ * pushed to the that index while any existing items previously located at or
+ * following the index will be shifted to right. Returns the mutated array.
+ * @param array - The array to mutate and push the new nodes onto
+ * @param index - The zero index to start the new nodes.
+ * @param items - New items to push onto the array
+ */ export function arrayPushAtIndex(array, index, ...items) {
+    if (isNaN(index)) array.push(...items);
+    else array.splice(index, 0, ...items);
+    return array;
+}
+export default arrayPushAtIndex;
+
+//# sourceMappingURL=array-push-at-index.js.map

package/src/lib/array/array-push-at-index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/array/array-push-at-index.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 * Mutates the existing array by adding new items onto the array at the provided\n * zero-based index. When the index is NaN, new items will be pushed onto the end\n * of the array. When the index is greater than or equal to 0, new items will be\n * pushed to the that index while any existing items previously located at or\n * following the index will be shifted to right. Returns the mutated array.\n * @param array - The array to mutate and push the new nodes onto\n * @param index - The zero index to start the new nodes.\n * @param items - New items to push onto the array\n */\nexport function arrayPushAtIndex<T>(\n  array: Array<T>,\n  index: number,\n  ...items: T[]\n): Array<T> {\n  if (isNaN(index)) array.push(...items)\n  else array.splice(index, 0, ...items)\n  return array\n}\nexport default arrayPushAtIndex\n"],"names":["arrayPushAtIndex","array","index","items","isNaN","push","splice"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;CASC,GACD,OAAO,SAASA,iBACdC,KAAe,EACfC,KAAa,EACb,GAAGC,KAAU;IAEb,IAAIC,MAAMF,QAAQD,MAAMI,IAAI,IAAIF;SAC3BF,MAAMK,MAAM,CAACJ,OAAO,MAAMC;IAC/B,OAAOF;AACT;AACA,eAAeD,iBAAgB"}

package/src/lib/array/array-remove-at-index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @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.
+ */
+/**
+ * Remove an item from the array at the provided zero index
+ * @param array - Array list to remove the item from
+ * @param index - Index of item to remove
+ */
+export declare function arrayRemoveAtIndex<T>(array: Array<T>, index: number): Array<T>;
+export default arrayRemoveAtIndex;

package/src/lib/array/array-remove-at-index.js

@@ -0,0 +1,26 @@
+/**
+ * @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.
+ */ /**
+ * Remove an item from the array at the provided zero index
+ * @param array - Array list to remove the item from
+ * @param index - Index of item to remove
+ */ export function arrayRemoveAtIndex(array, index) {
+    array.splice(index, 1);
+    return array;
+}
+export default arrayRemoveAtIndex;
+
+//# sourceMappingURL=array-remove-at-index.js.map

package/src/lib/array/array-remove-at-index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/array/array-remove-at-index.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/**\n * Remove an item from the array at the provided zero index\n * @param array - Array list to remove the item from\n * @param index - Index of item to remove\n */\nexport function arrayRemoveAtIndex<T>(array: Array<T>, index: number): Array<T> {\n  array.splice(index, 1)\n  return array\n}\nexport default arrayRemoveAtIndex\n"],"names":["arrayRemoveAtIndex","array","index","splice"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAGD;;;;CAIC,GACD,OAAO,SAASA,mBAAsBC,KAAe,EAAEC,KAAa;IAClED,MAAME,MAAM,CAACD,OAAO;IACpB,OAAOD;AACT;AACA,eAAeD,mBAAkB"}

package/src/lib/array/array-remove-item.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @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.
+ */
+/**
+ * Remove an item using strict equality when match
+ * @param array - Array to mutate and remove the match
+ * @param item - Item to search for strict equality comparison
+ */
+export declare function arrayRemoveItem<T>(array: Array<T>, item: T): Array<T>;
+export default arrayRemoveItem;

package/src/lib/array/array-remove-item.js

@@ -0,0 +1,27 @@
+/**
+ * @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.
+ */ /**
+ * Remove an item using strict equality when match
+ * @param array - Array to mutate and remove the match
+ * @param item - Item to search for strict equality comparison
+ */ export function arrayRemoveItem(array, item) {
+    const index = array.indexOf(item);
+    if (index >= 0) array.splice(index, 1);
+    return array;
+}
+export default arrayRemoveItem;
+
+//# sourceMappingURL=array-remove-item.js.map

package/src/lib/array/array-remove-item.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/array/array-remove-item.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/**\n * Remove an item using strict equality when match\n * @param array - Array to mutate and remove the match\n * @param item - Item to search for strict equality comparison\n */\nexport function arrayRemoveItem<T>(array: Array<T>, item: T): Array<T> {\n  const index = array.indexOf(item)\n  if (index >= 0) array.splice(index, 1)\n  return array\n}\nexport default arrayRemoveItem\n"],"names":["arrayRemoveItem","array","item","index","indexOf","splice"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAGD;;;;CAIC,GACD,OAAO,SAASA,gBAAmBC,KAAe,EAAEC,IAAO;IACzD,MAAMC,QAAQF,MAAMG,OAAO,CAACF;IAC5B,IAAIC,SAAS,GAAGF,MAAMI,MAAM,CAACF,OAAO;IACpC,OAAOF;AACT;AACA,eAAeD,gBAAe"}

package/src/lib/array/array-safe.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @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.
+ */
+/**
+ * Safe array, will always return an array
+ */
+export declare function arraySafe<T>(val: T[] | T, or?: any, wrapValid?: boolean): T[];
+export default arraySafe;

package/src/lib/array/array-safe.js

@@ -0,0 +1,29 @@
+/**
+ * @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.
+ */ import { _isArr } from "../guards/lib/_is-arr.js";
+/**
+ * Safe array, will always return an array
+ */ export function arraySafe(val, or, wrapValid = false) {
+    if (_isArr(val)) return val;
+    if (wrapValid && val) return [
+        val
+    ];
+    if (_isArr(or)) return or;
+    return [];
+}
+export default arraySafe;
+
+//# sourceMappingURL=array-safe.js.map

package/src/lib/array/array-safe.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/array/array-safe.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\nimport { _isArr } from '../guards/lib/_is-arr'\n\n\n/**\n * Safe array, will always return an array\n */\nexport function arraySafe<T>(val: T[] | T, or?: any, wrapValid = false): T[] {\n  if (_isArr(val)) return val\n  if (wrapValid && val) return [val]\n  if (_isArr(or)) return or\n  return []\n}\n\nexport default arraySafe\n"],"names":["_isArr","arraySafe","val","or","wrapValid"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,MAAM,QAAQ,2BAAuB;AAG9C;;CAEC,GACD,OAAO,SAASC,UAAaC,GAAY,EAAEC,EAAQ,EAAEC,YAAY,KAAK;IACpE,IAAIJ,OAAOE,MAAM,OAAOA;IACxB,IAAIE,aAAaF,KAAK,OAAO;QAACA;KAAI;IAClC,IAAIF,OAAOG,KAAK,OAAOA;IACvB,OAAO,EAAE;AACX;AAEA,eAAeF,UAAS"}

package/src/lib/array/array-sort-by-deep-property.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @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.
+ */
+/**
+ * Sort an array of objects by a specified property or property path, optionally second
+ * specify a secondary sorter for when left equals right
+ * @param {T[]} items
+ * @param {string} firstPath
+ * @param {string} secondPath
+ * @returns {T[]}
+ */
+export declare function arraySortByDeepProperty<T>(items: T[], firstPath: string, secondPath?: string): T[];
+export default arraySortByDeepProperty;

package/src/lib/array/array-sort-by-deep-property.js

@@ -0,0 +1,39 @@
+/**
+ * @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 { objectGetDeepProperty } from "../object/object-get-deep-property.js";
+/**
+ * Sort an array of objects by a specified property or property path, optionally second
+ * specify a secondary sorter for when left equals right
+ * @param {T[]} items
+ * @param {string} firstPath
+ * @param {string} secondPath
+ * @returns {T[]}
+ */ export function arraySortByDeepProperty(items, firstPath, secondPath) {
+    const lgr = (a, b, p)=>objectGetDeepProperty(a, p) > objectGetDeepProperty(b, p);
+    const eq = (a, b, p)=>objectGetDeepProperty(a, p) === objectGetDeepProperty(b, p);
+    return items.sort((a, b)=>{
+        if (lgr(a, b, firstPath)) return 1;
+        if (eq(a, b, firstPath)) {
+            if (!secondPath) return 0;
+            if (lgr(a, b, secondPath)) return 1;
+            if (eq(a, b, secondPath)) return 0;
+        }
+        return -1;
+    });
+}
+export default arraySortByDeepProperty;
+
+//# sourceMappingURL=array-sort-by-deep-property.js.map

package/src/lib/array/array-sort-by-deep-property.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/array/array-sort-by-deep-property.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 {objectGetDeepProperty} from '../object/object-get-deep-property'\n\n\n/**\n * Sort an array of objects by a specified property or property path, optionally second\n * specify a secondary sorter for when left equals right\n * @param {T[]} items\n * @param {string} firstPath\n * @param {string} secondPath\n * @returns {T[]}\n */\nexport function arraySortByDeepProperty<T>(\n  items: T[],\n  firstPath: string,\n  secondPath?: string,\n): T[] {\n  const lgr = (a: T, b: T, p: string) => objectGetDeepProperty(a, p) > objectGetDeepProperty(b, p)\n  const eq = (a: T, b: T, p: string) => objectGetDeepProperty(a, p) === objectGetDeepProperty(b, p)\n  return items.sort((a, b) => {\n    if (lgr(a, b, firstPath)) return 1\n    if (eq(a, b, firstPath)) {\n      if (!secondPath) return 0\n      if (lgr(a, b, secondPath)) return 1\n      if (eq(a, b, secondPath)) return 0\n    }\n    return -1\n  })\n}\n\nexport default arraySortByDeepProperty\n"],"names":["objectGetDeepProperty","arraySortByDeepProperty","items","firstPath","secondPath","lgr","a","b","p","eq","sort"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAAQA,qBAAqB,QAAO,wCAAoC;AAGxE;;;;;;;CAOC,GACD,OAAO,SAASC,wBACdC,KAAU,EACVC,SAAiB,EACjBC,UAAmB;IAEnB,MAAMC,MAAM,CAACC,GAAMC,GAAMC,IAAcR,sBAAsBM,GAAGE,KAAKR,sBAAsBO,GAAGC;IAC9F,MAAMC,KAAK,CAACH,GAAMC,GAAMC,IAAcR,sBAAsBM,GAAGE,OAAOR,sBAAsBO,GAAGC;IAC/F,OAAON,MAAMQ,IAAI,CAAC,CAACJ,GAAGC;QACpB,IAAIF,IAAIC,GAAGC,GAAGJ,YAAY,OAAO;QACjC,IAAIM,GAAGH,GAAGC,GAAGJ,YAAY;YACvB,IAAI,CAACC,YAAY,OAAO;YACxB,IAAIC,IAAIC,GAAGC,GAAGH,aAAa,OAAO;YAClC,IAAIK,GAAGH,GAAGC,GAAGH,aAAa,OAAO;QACnC;QACA,OAAO,CAAC;IACV;AACF;AAEA,eAAeH,wBAAuB"}

package/src/lib/array/array-sort-by.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @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.
+ */
+/**
+ * Sort iterable by property or index returned from callbackFn
+ * @export`
+ * @param {T[]} target
+ * @param {(item: T) => (string | number)} callbackFn
+ * @param thisArg
+ * @returns {T[]}
+ */
+export declare function arraySortBy<T>(target: T[], callbackFn: (item: T, target: T[]) => string | number, thisArg?: ThisType<unknown>): T[];
+export default arraySortBy;