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

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/object/object-clone.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 * Shallow copy iterable properties in iterable or array\n */\nexport function objectClone<T>(\n  target: Record<keyof any, T>,\n): Record<keyof any, T> {\n  return { ...target }\n}\n\nexport default objectClone\n"],"names":["objectClone","target"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED;;CAEC,GACD,OAAO,SAASA,YACdC,MAA4B;IAE5B,OAAO,aAAKA;AACd;AAEA,eAAeD,YAAW"}

package/src/lib/object/object-delete-property.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.
+ */
+/**
+ * Removes a named property in an object.Modifies the existing object unless
+ * provided `{copy: true}` for options
+ *
+ * @example
+ * const alpha = `{ping: 'foo', pong: 'bar'}`
+ * const bravo = `objectDeleteProperty(alpha, 'ping') // {pong: 'bar'}`
+ */
+export declare function objectDeleteProperty<T, K extends keyof T>(obj: T, key: K, options?: {
+    copy: boolean;
+}): Omit<T, K>;
+export default objectDeleteProperty;

package/src/lib/object/object-delete-property.js

@@ -0,0 +1,32 @@
+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.
+ */ /**
+ * Removes a named property in an object.Modifies the existing object unless
+ * provided `{copy: true}` for options
+ *
+ * @example
+ * const alpha = `{ping: 'foo', pong: 'bar'}`
+ * const bravo = `objectDeleteProperty(alpha, 'ping') // {pong: 'bar'}`
+ */ export function objectDeleteProperty(obj, key, options) {
+    const { copy } = _extends({}, options);
+    const res = copy ? _extends({}, obj) : obj;
+    delete res[key];
+    return res;
+}
+export default objectDeleteProperty;
+
+//# sourceMappingURL=object-delete-property.js.map

package/src/lib/object/object-delete-property.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/object/object-delete-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\n/**\n * Removes a named property in an object.Modifies the existing object unless\n * provided `{copy: true}` for options\n *\n * @example\n * const alpha = `{ping: 'foo', pong: 'bar'}`\n * const bravo = `objectDeleteProperty(alpha, 'ping') // {pong: 'bar'}`\n */\nexport function objectDeleteProperty<T, K extends keyof T>(\n  obj: T,\n  key: K,\n  options?: { copy: boolean },\n): Omit<T, K> {\n  const { copy } = { ...options }\n  const res = copy ? { ...obj } : obj\n  delete res[key]\n  return res\n}\n\nexport default objectDeleteProperty\n"],"names":["objectDeleteProperty","obj","key","options","copy","res"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;CAOC,GACD,OAAO,SAASA,qBACdC,GAAM,EACNC,GAAM,EACNC,OAA2B;IAE3B,MAAM,EAAEC,IAAI,EAAE,GAAG,aAAKD;IACtB,MAAME,MAAMD,OAAO,aAAKH,OAAQA;IAChC,OAAOI,GAAG,CAACH,IAAI;IACf,OAAOG;AACT;AAEA,eAAeL,qBAAoB"}

package/src/lib/object/object-get-deep-property.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @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.
+ */
+/**
+ * Get a nested property within an object literal
+ *
+ * EXAMPLE:
+ * const obj = {'a': {'prop': {'that': 'exists'}}};
+ * getNestedProperty(obj, 'a.very.deep.prop', 'value')
+ *
+ * @see getProperty
+ * @see objectSetDeepProperty
+ *
+ * @export
+ * @template T
+ * @param {T} obj
+ * @param {string} path
+ * @param {string} [separator='.']
+ * @returns {*}
+ */
+export declare function objectGetDeepProperty<U, T = any>(obj: T, path: string, separator?: string): U;
+export default objectGetDeepProperty;

package/src/lib/object/object-get-deep-property.js

@@ -0,0 +1,40 @@
+/**
+ * @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.
+ */ /**
+ * Get a nested property within an object literal
+ *
+ * EXAMPLE:
+ * const obj = {'a': {'prop': {'that': 'exists'}}};
+ * getNestedProperty(obj, 'a.very.deep.prop', 'value')
+ *
+ * @see getProperty
+ * @see objectSetDeepProperty
+ *
+ * @export
+ * @template T
+ * @param {T} obj
+ * @param {string} path
+ * @param {string} [separator='.']
+ * @returns {*}
+ */ export function objectGetDeepProperty(obj, path, separator = '.') {
+    const keys = path.split(separator);
+    const lastKey = keys.pop();
+    const lastObj = keys.reduce((v, k)=>v == null ? void 0 : v[k], obj);
+    return lastObj == null ? void 0 : lastObj[lastKey];
+}
+export default objectGetDeepProperty;
+
+//# sourceMappingURL=object-get-deep-property.js.map

package/src/lib/object/object-get-deep-property.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/object/object-get-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\n/**\n * Get a nested property within an object literal\n *\n * EXAMPLE:\n * const obj = {'a': {'prop': {'that': 'exists'}}};\n * getNestedProperty(obj, 'a.very.deep.prop', 'value')\n *\n * @see getProperty\n * @see objectSetDeepProperty\n *\n * @export\n * @template T\n * @param {T} obj\n * @param {string} path\n * @param {string} [separator='.']\n * @returns {*}\n */\nexport function objectGetDeepProperty<U, T = any>(\n  obj: T,\n  path: string,\n  separator = '.',\n): U {\n  const keys = path.split(separator)\n  const lastKey = keys.pop()\n  const lastObj = keys.reduce((v: any, k) => v?.[k], obj as any)\n  return lastObj?.[lastKey]\n}\n\nexport default objectGetDeepProperty\n"],"names":["objectGetDeepProperty","obj","path","separator","keys","split","lastKey","pop","lastObj","reduce","v","k"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;CAgBC,GACD,OAAO,SAASA,sBACdC,GAAM,EACNC,IAAY,EACZC,YAAY,GAAG;IAEf,MAAMC,OAAOF,KAAKG,KAAK,CAACF;IACxB,MAAMG,UAAUF,KAAKG,GAAG;IACxB,MAAMC,UAAUJ,KAAKK,MAAM,CAAC,CAACC,GAAQC,IAAMD,qBAAAA,CAAG,CAACC,EAAE,EAAEV;IACnD,OAAOO,2BAAAA,OAAS,CAACF,QAAQ;AAC3B;AAEA,eAAeN,sBAAqB"}

package/src/lib/object/object-get-keys-and-symbol-properties.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.
+ */
+/**
+ * Retrieve all keys of source object and symbol properties found directly
+ * @param {T} obj
+ * @returns {K[]}
+ */
+export declare function objectGetKeysAndSymbolProperties<T, K extends keyof T>(obj: T): K[];
+export default objectGetKeysAndSymbolProperties;

package/src/lib/object/object-get-keys-and-symbol-properties.js

@@ -0,0 +1,30 @@
+/**
+ * @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.
+ */ /**
+ * Retrieve all keys of source object and symbol properties found directly
+ * @param {T} obj
+ * @returns {K[]}
+ */ export function objectGetKeysAndSymbolProperties(obj) {
+    const keys = Object.keys(obj);
+    if (Object.getOwnPropertySymbols) {
+        const propertySymbols = Object.getOwnPropertySymbols(obj);
+        return keys.concat(propertySymbols);
+    }
+    return keys;
+}
+export default objectGetKeysAndSymbolProperties;
+
+//# sourceMappingURL=object-get-keys-and-symbol-properties.js.map

package/src/lib/object/object-get-keys-and-symbol-properties.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/object/object-get-keys-and-symbol-properties.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 * Retrieve all keys of source object and symbol properties found directly\n * @param {T} obj\n * @returns {K[]}\n */\nexport function objectGetKeysAndSymbolProperties<T, K extends keyof T>(\n  obj: T,\n): K[] {\n  const keys: K[] = Object.keys(obj) as K[]\n  if (Object.getOwnPropertySymbols) {\n    const propertySymbols = Object.getOwnPropertySymbols(obj)\n    return keys.concat(propertySymbols as K[])\n  }\n  return keys\n}\n\nexport default objectGetKeysAndSymbolProperties\n"],"names":["objectGetKeysAndSymbolProperties","obj","keys","Object","getOwnPropertySymbols","propertySymbols","concat"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;CAIC,GACD,OAAO,SAASA,iCACdC,GAAM;IAEN,MAAMC,OAAYC,OAAOD,IAAI,CAACD;IAC9B,IAAIE,OAAOC,qBAAqB,EAAE;QAChC,MAAMC,kBAAkBF,OAAOC,qBAAqB,CAACH;QACrD,OAAOC,KAAKI,MAAM,CAACD;IACrB;IACA,OAAOH;AACT;AAEA,eAAeF,iCAAgC"}

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

@@ -0,0 +1,33 @@
+/**
+ * @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.
+ */
+export type RemapOptions = {
+    /** When true will remove 'undefined' values */
+    remove?: boolean;
+    copy?: 'deep' | 'shallow' | boolean;
+};
+export type RemapTarget<K extends PKey, V = unknown> = Record<K, V>;
+export type RemapCallback<K extends PKey, V, U = V> = (value: V, key: K, target: RemapTarget<K, V>) => U;
+export type RemapOutputDefault<T extends RemapTarget<K, V>, K extends PKey, V, U = V> = RemapTarget<K, U>;
+export type RemapOutputFiltered<T extends RemapTarget<K, V>, K extends PKey, V, U = V> = OmitIndexOfType<RemapOutputDefault<T, K, V, U>, NUN>;
+export type RemapOutput<T extends RemapTarget<K, V>, K extends PKey, V, U = V, O extends RemapOptions = any> = O extends {
+    remove: true;
+} ? RemapOutputFiltered<T, K, V, U> : RemapOutputDefault<T, K, V, U>;
+/**
+ * Map an object keys and values
+ */
+export declare function objectRemap<K extends PKey, V, U = V, T = RemapTarget<K, V>>(target: RemapTarget<K, V>, callbackFn: RemapCallback<K, V, U>, options?: RemapOptions, thisArg?: ThisType<T>): RemapOutput<typeof target, K, V, U, typeof options>;
+export default objectRemap;

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

@@ -0,0 +1,36 @@
+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 { _isUndT } from "../guards/lib/_is-und-t.js";
+import cloneDeep from "../copy.js";
+/**
+ * Map an object keys and values
+ */ export function objectRemap(target, callbackFn, options, thisArg) {
+    // prettier-ignore
+    const remapped = (options == null ? void 0 : options.copy) === 'deep' ? cloneDeep(target) : (options == null ? void 0 : options.copy) === 'shallow' || (options == null ? void 0 : options.copy) === true ? _extends({}, target) : target;
+    const _thisArg = thisArg != null ? thisArg : remapped;
+    for(const key in target){
+        if (Object.hasOwn(target, key)) {
+            const value = callbackFn.call(_thisArg, target[key], key, target);
+            if ((options == null ? void 0 : options.remove) && _isUndT(value)) delete remapped[key];
+            else remapped[key] = value;
+        }
+    }
+    return remapped;
+}
+export default objectRemap;
+
+//# sourceMappingURL=object-remap.js.map

package/src/lib/object/object-remap.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/object/object-remap.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 { _isUndT } from '../guards/lib/_is-und-t'\nimport cloneDeep from '../copy'\n\nexport type RemapOptions = {\n  /** When true will remove 'undefined' values */\n  remove?: boolean\n  copy?: 'deep' | 'shallow' | boolean\n}\n\nexport type RemapTarget<K extends PKey, V = unknown> = Record<K, V>\n\nexport type RemapCallback<K extends PKey, V, U = V> = (\n  value: V,\n  key: K,\n  target: RemapTarget<K, V>,\n) => U\n\nexport type RemapOutputDefault<\n  T extends RemapTarget<K, V>,\n  K extends PKey,\n  V,\n  U = V,\n> = RemapTarget<K, U>\n\n// prettier-ignore\nexport type RemapOutputFiltered<\n  T extends RemapTarget<K, V>,\n  K extends PKey,\n  V,\n  U = V,\n> = OmitIndexOfType<\n  RemapOutputDefault<T, K, V, U>,\n  NUN\n>\n\n// prettier-ignore\nexport type RemapOutput<\n  T extends RemapTarget<K, V>,\n  K extends PKey,\n  V,\n  U = V,\n  O extends RemapOptions = any\n> =\n  O extends {remove: true}\n    ? RemapOutputFiltered<T, K, V, U>\n    : RemapOutputDefault<T, K, V, U>\n\n/**\n * Map an object keys and values\n */\nexport function objectRemap<K extends PKey, V, U = V, T = RemapTarget<K, V>>(\n  target: RemapTarget<K, V>,\n  callbackFn: RemapCallback<K, V, U>,\n  options?: RemapOptions,\n  thisArg?: ThisType<T>,\n): RemapOutput<typeof target, K, V, U, typeof options> {\n  type ThisArg = Conditional<typeof thisArg, NUN, typeof target, typeof thisArg>\n  type Output = RemapOutput<typeof target, K, V, U, typeof options>\n\n  // prettier-ignore\n  const remapped = (\n    options?.copy === 'deep'\n      ? cloneDeep(target)\n      : (\n        options?.copy === 'shallow' || options?.copy === true\n          ? {...target}\n          : target\n      )\n  ) as unknown as Output\n\n  const _thisArg = (thisArg ?? remapped) as ThisArg\n\n  for (const key in target) {\n    if (Object.hasOwn(target, key)) {\n      const value = callbackFn.call(_thisArg, target[key], key, target)\n      if (options?.remove && _isUndT(value)) delete remapped[key]\n      else remapped[key] = value\n    }\n  }\n\n  return remapped\n}\n\nexport default objectRemap\n"],"names":["_isUndT","cloneDeep","objectRemap","target","callbackFn","options","thisArg","remapped","copy","_thisArg","key","Object","hasOwn","value","call","remove"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,OAAO,QAAQ,6BAAyB;AACjD,OAAOC,eAAe,aAAS;AA8C/B;;CAEC,GACD,OAAO,SAASC,YACdC,MAAyB,EACzBC,UAAkC,EAClCC,OAAsB,EACtBC,OAAqB;IAKrB,kBAAkB;IAClB,MAAMC,WACJF,CAAAA,2BAAAA,QAASG,IAAI,MAAK,SACdP,UAAUE,UAEVE,CAAAA,2BAAAA,QAASG,IAAI,MAAK,aAAaH,CAAAA,2BAAAA,QAASG,IAAI,MAAK,OAC7C,aAAIL,UACJA;IAIV,MAAMM,WAAYH,kBAAAA,UAAWC;IAE7B,IAAK,MAAMG,OAAOP,OAAQ;QACxB,IAAIQ,OAAOC,MAAM,CAACT,QAAQO,MAAM;YAC9B,MAAMG,QAAQT,WAAWU,IAAI,CAACL,UAAUN,MAAM,CAACO,IAAI,EAAEA,KAAKP;YAC1D,IAAIE,CAAAA,2BAAAA,QAASU,MAAM,KAAIf,QAAQa,QAAQ,OAAON,QAAQ,CAACG,IAAI;iBACtDH,QAAQ,CAACG,IAAI,GAAGG;QACvB;IACF;IAEA,OAAON;AACT;AAEA,eAAeL,YAAW"}

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

@@ -0,0 +1,27 @@
+/**
+ * @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 object/{} will always return an object
+ *
+ * @export
+ * @template T
+ * @param {T} val
+ * @param {Record<string, unknown>} [or]
+ * @returns {Record<string, unknown>}
+ */
+export declare function objectSafe<T>(val: T, or?: Record<string, unknown>): Record<string, unknown>;
+export default objectSafe;

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

@@ -0,0 +1,30 @@
+/**
+ * @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 { _isObj } from "../guards/index.js";
+/**
+ * Safe object/{} will always return an object
+ *
+ * @export
+ * @template T
+ * @param {T} val
+ * @param {Record<string, unknown>} [or]
+ * @returns {Record<string, unknown>}
+ */ export function objectSafe(val, or) {
+    return _isObj(val) ? val : _isObj(or) ? or : {};
+}
+export default objectSafe;
+
+//# sourceMappingURL=object-safe.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/object/object-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 { _isObj } from '../guards'\n\n\n/**\n * Safe object/{} will always return an object\n *\n * @export\n * @template T\n * @param {T} val\n * @param {Record<string, unknown>} [or]\n * @returns {Record<string, unknown>}\n */\nexport function objectSafe<T>(\n  val: T,\n  or?: Record<string, unknown>,\n): Record<string, unknown> {\n  return _isObj(val) ? val : _isObj(or) ? or : {}\n}\n\nexport default objectSafe\n"],"names":["_isObj","objectSafe","val","or"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,MAAM,QAAQ,qBAAW;AAGlC;;;;;;;;CAQC,GACD,OAAO,SAASC,WACdC,GAAM,EACNC,EAA4B;IAE5B,OAAOH,OAAOE,OAAOA,MAAMF,OAAOG,MAAMA,KAAK,CAAC;AAChD;AAEA,eAAeF,WAAU"}

package/src/lib/object/object-set-deep-property.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @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.
+ */
+/**
+ * Set a nested property within an object literal
+ *
+ * EXAMPLE:
+ * const obj = {'a': {'prop': {'that': 'exists'}}};
+ * setNestedProperty(obj, 'a.very.deep.prop', 'value')
+ *
+ * @see getProperty
+ * @see objectGetDeepProperty
+ *
+ * @export
+ * @template T
+ * @param {T} obj
+ * @param {string} path
+ * @param {*} val
+ * @param {string} [separator='.']
+ */
+export declare function objectSetDeepProperty<T>(obj: T, path: string, val: any, separator?: string): T;
+export default objectSetDeepProperty;

package/src/lib/object/object-set-deep-property.js

@@ -0,0 +1,44 @@
+/**
+ * @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.
+ */ /**
+ * Set a nested property within an object literal
+ *
+ * EXAMPLE:
+ * const obj = {'a': {'prop': {'that': 'exists'}}};
+ * setNestedProperty(obj, 'a.very.deep.prop', 'value')
+ *
+ * @see getProperty
+ * @see objectGetDeepProperty
+ *
+ * @export
+ * @template T
+ * @param {T} obj
+ * @param {string} path
+ * @param {*} val
+ * @param {string} [separator='.']
+ */ export function objectSetDeepProperty(obj, path, val, separator = '.') {
+    const keys = path.split(separator);
+    const lastKey = keys.pop();
+    const lastObj = keys.reduce((acc, item)=>{
+        var _acc, _item, _;
+        return (_ = (_acc = acc)[_item = item]) != null ? _ : _acc[_item] = {};
+    }, obj);
+    lastObj[lastKey] = val;
+    return obj;
+}
+export default objectSetDeepProperty;
+
+//# sourceMappingURL=object-set-deep-property.js.map

package/src/lib/object/object-set-deep-property.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/object/object-set-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\n/**\n * Set a nested property within an object literal\n *\n * EXAMPLE:\n * const obj = {'a': {'prop': {'that': 'exists'}}};\n * setNestedProperty(obj, 'a.very.deep.prop', 'value')\n *\n * @see getProperty\n * @see objectGetDeepProperty\n *\n * @export\n * @template T\n * @param {T} obj\n * @param {string} path\n * @param {*} val\n * @param {string} [separator='.']\n */\nexport function objectSetDeepProperty<T>(\n  obj: T,\n  path: string,\n  val: any,\n  separator = '.',\n): T {\n  const keys = path.split(separator)\n  const lastKey = keys.pop()\n  const lastObj = keys.reduce((acc: any, item) => (acc[item] ??= {}), obj as any)\n  lastObj[lastKey] = val\n  return obj\n}\n\nexport default objectSetDeepProperty\n"],"names":["objectSetDeepProperty","obj","path","val","separator","keys","split","lastKey","pop","lastObj","reduce","acc","item"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;CAgBC,GACD,OAAO,SAASA,sBACdC,GAAM,EACNC,IAAY,EACZC,GAAQ,EACRC,YAAY,GAAG;IAEf,MAAMC,OAAOH,KAAKI,KAAK,CAACF;IACxB,MAAMG,UAAUF,KAAKG,GAAG;IACxB,MAAMC,UAAUJ,KAAKK,MAAM,CAAC,CAACC,KAAUC;YAAUD,MAAIC,OAAJD;gBAAAA,IAAAA,CAAAA,OAAAA,IAAG,CAACC,QAAAA,KAAK,YAATD,IAAAA,IAAG,CAACC,MAAK,GAAK,CAAC;OAAIX;IACpEQ,OAAO,CAACF,QAAQ,GAAGJ;IACnB,OAAOF;AACT;AAEA,eAAeD,sBAAqB"}

package/src/lib/object/object-update.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.
+ */
+/**
+ * Shortcut for Object.assign({}, target, ...otherTargets)
+ *
+ * @export
+ * @template T
+ * @template U
+ * @param {T} target
+ * @param {...U[]} source
+ * @returns {(T & U)}
+ */
+export declare function objectUpdate<T, U>(target: T, ...source: U[]): T & U;
+export default objectUpdate;

package/src/lib/object/object-update.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.
+ */ /**
+ * Shortcut for Object.assign({}, target, ...otherTargets)
+ *
+ * @export
+ * @template T
+ * @template U
+ * @param {T} target
+ * @param {...U[]} source
+ * @returns {(T & U)}
+ */ export function objectUpdate(target, ...source) {
+    // Encapsulate the idea of passing a new object as the first parameter
+    // to Object.assign to ensure we correctly copy data instead of mutating
+    return Object.assign({}, target, ...source);
+}
+export default objectUpdate;
+
+//# sourceMappingURL=object-update.js.map

package/src/lib/object/object-update.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/object/object-update.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 * Shortcut for Object.assign({}, target, ...otherTargets)\n *\n * @export\n * @template T\n * @template U\n * @param {T} target\n * @param {...U[]} source\n * @returns {(T & U)}\n */\nexport function objectUpdate<T, U>(target: T, ...source: U[]): T & U {\n  // Encapsulate the idea of passing a new object as the first parameter\n  // to Object.assign to ensure we correctly copy data instead of mutating\n  return Object.assign({}, target, ...source)\n}\n\nexport default objectUpdate\n"],"names":["objectUpdate","target","source","Object","assign"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;CASC,GACD,OAAO,SAASA,aAAmBC,MAAS,EAAE,GAAGC,MAAW;IAC1D,sEAAsE;IACtE,wEAAwE;IACxE,OAAOC,OAAOC,MAAM,CAAC,CAAC,GAAGH,WAAWC;AACtC;AAEA,eAAeF,aAAY"}

package/src/lib/operator/compare.d.ts

@@ -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.
+ */
+import type { ComparisonOperator } from './definitions';
+/**
+ * Perform comparison operation to check provided equality operator. If no
+ * operator is provided defaults to strict equality check
+ * @param left - left-hand side operand for operation
+ * @param right - right-hand side operand for operation
+ * @param operator - provide js comparison operator syntax as string literal
+ */
+export declare function compare<T>(left: Iterable<T> | ArrayLike<T> | number | string, right: Iterable<T> | ArrayLike<T> | number | string, operator?: ComparisonOperator): boolean;
+export default compare;

package/src/lib/operator/compare.js

@@ -0,0 +1,42 @@
+/**
+ * @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.
+ */ /**
+ * Perform comparison operation to check provided equality operator. If no
+ * operator is provided defaults to strict equality check
+ * @param left - left-hand side operand for operation
+ * @param right - right-hand side operand for operation
+ * @param operator - provide js comparison operator syntax as string literal
+ */ export function compare(left, right, operator = '===') {
+    switch(operator){
+        case '==':
+            // noinspection EqualityComparisonWithCoercionJS
+            return left == right;
+        case '<':
+            return left < right;
+        case '<=':
+            return left <= right;
+        case '>=':
+            return left >= right;
+        case '>':
+            return left > right;
+        case '===':
+        default:
+            return left === right;
+    }
+}
+export default compare;
+
+//# sourceMappingURL=compare.js.map

package/src/lib/operator/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/operator/compare.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 type { ComparisonOperator } from './definitions'\n\n\n/**\n * Perform comparison operation to check provided equality operator. If no\n * operator is provided defaults to strict equality check\n * @param left - left-hand side operand for operation\n * @param right - right-hand side operand for operation\n * @param operator - provide js comparison operator syntax as string literal\n */\nexport function compare<T>(\n  left: Iterable<T> | ArrayLike<T> | number | string,\n  right: Iterable<T> | ArrayLike<T> | number | string,\n  operator: ComparisonOperator = '===',\n): boolean {\n  switch (operator) {\n    case '==':\n      // noinspection EqualityComparisonWithCoercionJS\n      return left == right\n    case '<':\n      return left < right\n    case '<=':\n      return left <= right\n    case '>=':\n      return left >= right\n    case '>':\n      return left > right\n    case '===':\n    default:\n      return left === right\n  }\n}\n\nexport default compare\n"],"names":["compare","left","right","operator"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAKD;;;;;;CAMC,GACD,OAAO,SAASA,QACdC,IAAkD,EAClDC,KAAmD,EACnDC,WAA+B,KAAK;IAEpC,OAAQA;QACN,KAAK;YACH,gDAAgD;YAChD,OAAOF,QAAQC;QACjB,KAAK;YACH,OAAOD,OAAOC;QAChB,KAAK;YACH,OAAOD,QAAQC;QACjB,KAAK;YACH,OAAOD,QAAQC;QACjB,KAAK;YACH,OAAOD,OAAOC;QAChB,KAAK;QACL;YACE,OAAOD,SAASC;IACpB;AACF;AAEA,eAAeF,QAAO"}