@stryke/helpers 0.9.35 → 0.9.36

package/dist/deep-merge.mjs

@@ -1,2 +1,61 @@
-import{isFunction as e}from"./type-checks/src/is-function.mjs";import{isMergeableObject as t}from"./type-checks/src/is-mergeable-object.mjs";import{propertyUnsafe as n}from"./type-checks/src/property-exists.mjs";const r=e=>Array.isArray(e)?[]:{},i=(e,t)=>t.clone!==!1&&t.isMergeableObject(e)?l(r(e),e,t):e,a=(e,t,n)=>[...e,...t].map(e=>i(e,n)),o=(t,n)=>{if(!n.customMerge)return l;let r=n.customMerge(t);return e(r)?r:l},s=e=>[...Object.keys(e),...Object.getOwnPropertySymbols?Object.getOwnPropertySymbols(e).filter(t=>Object.propertyIsEnumerable.call(e,t)):[]],c=(e,t,r)=>{let a={};if(r.isMergeableObject(e))for(let t of s(e))a[t]=i(e[t],r);for(let c of s(t))a[c]=n(e,c)&&r.isMergeableObject(t[c])?o(c,r)(e[c],t[c],r):i(t[c],r);return a};function l(e,n,r){if(!e||!n)return e||n;let o=r??{};o.arrayMerge??=a,o.isMergeableObject??=t,o.cloneUnlessOtherwiseSpecified??=i;let s=Array.isArray(n);return s===Array.isArray(e)?s?o.arrayMerge(e,n,o):c(e,n,o):i(n,o)}l.all=function(e,t){if(!Array.isArray(e))throw TypeError(`first argument should be an array`);return e.reduce((e,n)=>l(e,n,t),{})};export{l as deepMerge};
+import { isFunction } from "./type-checks/src/is-function.mjs";
+import { isMergeableObject } from "./type-checks/src/is-mergeable-object.mjs";
+import { propertyUnsafe } from "./type-checks/src/property-exists.mjs";
+
+//#region src/deep-merge.ts
+const emptyTarget = (val) => {
+	return Array.isArray(val) ? [] : {};
+};
+const cloneUnlessOtherwiseSpecified = (value, options) => {
+	return options.clone !== false && options.isMergeableObject(value) ? deepMerge(emptyTarget(value), value, options) : value;
+};
+const defaultArrayMerge = (target, source, options) => {
+	return [...target, ...source].map((element) => {
+		return cloneUnlessOtherwiseSpecified(element, options);
+	});
+};
+const getMergeFunction = (key, options) => {
+	if (!options.customMerge) return deepMerge;
+	const customMerge = options.customMerge(key);
+	return isFunction(customMerge) ? customMerge : deepMerge;
+};
+const getKeys = (target) => {
+	return [...Object.keys(target), ...Object.getOwnPropertySymbols ? Object.getOwnPropertySymbols(target).filter((symbol) => {
+		return Object.propertyIsEnumerable.call(target, symbol);
+	}) : []];
+};
+const mergeObject = (target, source, options) => {
+	const destination = {};
+	if (options.isMergeableObject(target)) for (const key of getKeys(target)) destination[key] = cloneUnlessOtherwiseSpecified(target[key], options);
+	for (const key of getKeys(source)) destination[key] = propertyUnsafe(target, key) && options.isMergeableObject(source[key]) ? getMergeFunction(key, options)(target[key], source[key], options) : cloneUnlessOtherwiseSpecified(source[key], options);
+	return destination;
+};
+/**
+* Deep merge two objects
+*
+* @param target - The target object
+* @param source - The source object
+* @param options - The options object
+* @returns The merged object
+*/
+function deepMerge(target, source, options) {
+	if (!target || !source) return target || source;
+	const opts = options ?? {};
+	opts.arrayMerge ??= defaultArrayMerge;
+	opts.isMergeableObject ??= isMergeableObject;
+	opts.cloneUnlessOtherwiseSpecified ??= cloneUnlessOtherwiseSpecified;
+	const sourceIsArray = Array.isArray(source);
+	if (!(sourceIsArray === Array.isArray(target))) return cloneUnlessOtherwiseSpecified(source, opts);
+	if (sourceIsArray) return opts.arrayMerge(target, source, opts);
+	return mergeObject(target, source, opts);
+}
+deepMerge.all = function deepMergeAll(array, options) {
+	if (!Array.isArray(array)) throw new TypeError("first argument should be an array");
+	return array.reduce((prev, next) => {
+		return deepMerge(prev, next, options);
+	}, {});
+};
+
+//#endregion
+export { deepMerge };
 //# sourceMappingURL=deep-merge.mjs.map

package/dist/deep-merge.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"deep-merge.mjs","names":["destination: Record<string, any>"],"sources":["../src/deep-merge.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isFunction } from \"@stryke/type-checks/is-function\";\nimport { isMergeableObject } from \"@stryke/type-checks/is-mergeable-object\";\nimport { propertyUnsafe } from \"@stryke/type-checks/property-exists\";\n\nconst emptyTarget = (val: any) => {\n  return Array.isArray(val) ? [] : {};\n};\n\nconst cloneUnlessOtherwiseSpecified = (\n  value: any,\n  options: {\n    clone?: boolean;\n    isMergeableObject: (value: any) => boolean;\n  }\n) => {\n  return options.clone !== false && options.isMergeableObject(value)\n    ? deepMerge(emptyTarget(value), value, options)\n    : value;\n};\n\nconst defaultArrayMerge = (target: any[], source: any[], options?: any) => {\n  return [...target, ...source].map(element => {\n    return cloneUnlessOtherwiseSpecified(element, options);\n  });\n};\n\nconst getMergeFunction = (\n  key: string,\n  options: {\n    customMerge?: (key: string) => any;\n  }\n) => {\n  if (!options.customMerge) {\n    return deepMerge;\n  }\n  const customMerge = options.customMerge(key);\n\n  return isFunction(customMerge) ? customMerge : deepMerge;\n};\n\nconst getKeys = (target: Record<string, any>) => {\n  return [\n    ...Object.keys(target),\n    ...((Object.getOwnPropertySymbols\n      ? Object.getOwnPropertySymbols(target).filter(symbol => {\n          return Object.propertyIsEnumerable.call(target, symbol);\n        })\n      : []) as unknown as string[])\n  ];\n};\n\nconst mergeObject = (\n  target: Record<string, any>,\n  source: Record<string, any>,\n  options: {\n    clone?: boolean;\n    customMerge?: (key: string) => any;\n    isMergeableObject: (value: any) => boolean;\n    cloneUnlessOtherwiseSpecified?: (\n      value: any,\n      options: {\n        clone: boolean;\n        isMergeableObject: (value: any) => boolean;\n      }\n    ) => any;\n  }\n) => {\n  const destination: Record<string, any> = {};\n  if (options.isMergeableObject(target)) {\n    for (const key of getKeys(target)) {\n      destination[key] = cloneUnlessOtherwiseSpecified(target[key], options);\n    }\n  }\n  for (const key of getKeys(source)) {\n    destination[key] =\n      propertyUnsafe(target, key) && options.isMergeableObject(source[key])\n        ? getMergeFunction(key, options)(target[key], source[key], options)\n        : cloneUnlessOtherwiseSpecified(source[key], options);\n  }\n  return destination;\n};\n\nexport interface DeepMergeOptions {\n  clone?: boolean;\n  customMerge?: (key: string) => any;\n  isMergeableObject: (value: any) => boolean;\n  cloneUnlessOtherwiseSpecified: (\n    value: any,\n    options: {\n      clone?: boolean;\n      isMergeableObject: (value: any) => boolean;\n    }\n  ) => any;\n  arrayMerge: (target: any[], source: any[], options: any) => any;\n}\n\n/**\n * Deep merge two objects\n *\n * @param target - The target object\n * @param source - The source object\n * @param options - The options object\n * @returns The merged object\n */\nexport function deepMerge<X = any | any[], Y = any | any[], Z = X & Y>(\n  target: X,\n  source: Y,\n  options?: Partial<DeepMergeOptions>\n): Z {\n  if (!target || !source) {\n    return (target || source) as Z;\n  }\n\n  const opts = (options ?? {}) as DeepMergeOptions;\n  opts.arrayMerge ??= defaultArrayMerge;\n  opts.isMergeableObject ??= isMergeableObject;\n  // cloneUnlessOtherwiseSpecified is added to `options` so that custom arrayMerge()\n  // implementations can use it. The caller may not replace it.\n  opts.cloneUnlessOtherwiseSpecified ??= cloneUnlessOtherwiseSpecified;\n\n  const sourceIsArray = Array.isArray(source);\n  const targetIsArray = Array.isArray(target);\n  const sourceAndTargetTypesMatch = sourceIsArray === targetIsArray;\n\n  if (!sourceAndTargetTypesMatch) {\n    return cloneUnlessOtherwiseSpecified(source, opts);\n  }\n  if (sourceIsArray) {\n    return opts.arrayMerge(target as any[], source, opts);\n  }\n  return mergeObject(target, source, opts) as Z;\n}\n\ndeepMerge.all = function deepMergeAll(array: any[], options?: any) {\n  if (!Array.isArray(array)) {\n    throw new TypeError(\"first argument should be an array\");\n  }\n\n  return array.reduce((prev, next) => {\n    return deepMerge(prev, next, options);\n  }, {});\n};\n"],"mappings":"oNAsBA,MAAM,EAAe,GACZ,MAAM,QAAQ,EAAI,CAAG,EAAE,CAAG,EAAE,CAG/B,GACJ,EACA,IAKO,EAAQ,QAAU,IAAS,EAAQ,kBAAkB,EAAM,CAC9D,EAAU,EAAY,EAAM,CAAE,EAAO,EAAQ,CAC7C,EAGA,GAAqB,EAAe,EAAe,IAChD,CAAC,GAAG,EAAQ,GAAG,EAAO,CAAC,IAAI,GACzB,EAA8B,EAAS,EAAQ,CACtD,CAGE,GACJ,EACA,IAGG,CACH,GAAI,CAAC,EAAQ,YACX,OAAO,EAET,IAAM,EAAc,EAAQ,YAAY,EAAI,CAE5C,OAAO,EAAW,EAAY,CAAG,EAAc,GAG3C,EAAW,GACR,CACL,GAAG,OAAO,KAAK,EAAO,CACtB,GAAK,OAAO,sBACR,OAAO,sBAAsB,EAAO,CAAC,OAAO,GACnC,OAAO,qBAAqB,KAAK,EAAQ,EAAO,CACvD,CACF,EAAE,CACP,CAGG,GACJ,EACA,EACA,IAYG,CACH,IAAMA,EAAmC,EAAE,CAC3C,GAAI,EAAQ,kBAAkB,EAAO,CACnC,IAAK,IAAM,KAAO,EAAQ,EAAO,CAC/B,EAAY,GAAO,EAA8B,EAAO,GAAM,EAAQ,CAG1E,IAAK,IAAM,KAAO,EAAQ,EAAO,CAC/B,EAAY,GACV,EAAe,EAAQ,EAAI,EAAI,EAAQ,kBAAkB,EAAO,GAAK,CACjE,EAAiB,EAAK,EAAQ,CAAC,EAAO,GAAM,EAAO,GAAM,EAAQ,CACjE,EAA8B,EAAO,GAAM,EAAQ,CAE3D,OAAO,GAyBT,SAAgB,EACd,EACA,EACA,EACG,CACH,GAAI,CAAC,GAAU,CAAC,EACd,OAAQ,GAAU,EAGpB,IAAM,EAAQ,GAAW,EAAE,CAC3B,EAAK,aAAe,EACpB,EAAK,oBAAsB,EAG3B,EAAK,gCAAkC,EAEvC,IAAM,EAAgB,MAAM,QAAQ,EAAO,CAU3C,OARkC,IADZ,MAAM,QAAQ,EAAO,CAMvC,EACK,EAAK,WAAW,EAAiB,EAAQ,EAAK,CAEhD,EAAY,EAAQ,EAAQ,EAAK,CAL/B,EAA8B,EAAQ,EAAK,CAQtD,EAAU,IAAM,SAAsB,EAAc,EAAe,CACjE,GAAI,CAAC,MAAM,QAAQ,EAAM,CACvB,MAAU,UAAU,oCAAoC,CAG1D,OAAO,EAAM,QAAQ,EAAM,IAClB,EAAU,EAAM,EAAM,EAAQ,CACpC,EAAE,CAAC"}
+{"version":3,"file":"deep-merge.mjs","names":["destination: Record<string, any>"],"sources":["../src/deep-merge.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isFunction } from \"@stryke/type-checks/is-function\";\nimport { isMergeableObject } from \"@stryke/type-checks/is-mergeable-object\";\nimport { propertyUnsafe } from \"@stryke/type-checks/property-exists\";\n\nconst emptyTarget = (val: any) => {\n  return Array.isArray(val) ? [] : {};\n};\n\nconst cloneUnlessOtherwiseSpecified = (\n  value: any,\n  options: {\n    clone?: boolean;\n    isMergeableObject: (value: any) => boolean;\n  }\n) => {\n  return options.clone !== false && options.isMergeableObject(value)\n    ? deepMerge(emptyTarget(value), value, options)\n    : value;\n};\n\nconst defaultArrayMerge = (target: any[], source: any[], options?: any) => {\n  return [...target, ...source].map(element => {\n    return cloneUnlessOtherwiseSpecified(element, options);\n  });\n};\n\nconst getMergeFunction = (\n  key: string,\n  options: {\n    customMerge?: (key: string) => any;\n  }\n) => {\n  if (!options.customMerge) {\n    return deepMerge;\n  }\n  const customMerge = options.customMerge(key);\n\n  return isFunction(customMerge) ? customMerge : deepMerge;\n};\n\nconst getKeys = (target: Record<string, any>) => {\n  return [\n    ...Object.keys(target),\n    ...((Object.getOwnPropertySymbols\n      ? Object.getOwnPropertySymbols(target).filter(symbol => {\n          return Object.propertyIsEnumerable.call(target, symbol);\n        })\n      : []) as unknown as string[])\n  ];\n};\n\nconst mergeObject = (\n  target: Record<string, any>,\n  source: Record<string, any>,\n  options: {\n    clone?: boolean;\n    customMerge?: (key: string) => any;\n    isMergeableObject: (value: any) => boolean;\n    cloneUnlessOtherwiseSpecified?: (\n      value: any,\n      options: {\n        clone: boolean;\n        isMergeableObject: (value: any) => boolean;\n      }\n    ) => any;\n  }\n) => {\n  const destination: Record<string, any> = {};\n  if (options.isMergeableObject(target)) {\n    for (const key of getKeys(target)) {\n      destination[key] = cloneUnlessOtherwiseSpecified(target[key], options);\n    }\n  }\n  for (const key of getKeys(source)) {\n    destination[key] =\n      propertyUnsafe(target, key) && options.isMergeableObject(source[key])\n        ? getMergeFunction(key, options)(target[key], source[key], options)\n        : cloneUnlessOtherwiseSpecified(source[key], options);\n  }\n  return destination;\n};\n\nexport interface DeepMergeOptions {\n  clone?: boolean;\n  customMerge?: (key: string) => any;\n  isMergeableObject: (value: any) => boolean;\n  cloneUnlessOtherwiseSpecified: (\n    value: any,\n    options: {\n      clone?: boolean;\n      isMergeableObject: (value: any) => boolean;\n    }\n  ) => any;\n  arrayMerge: (target: any[], source: any[], options: any) => any;\n}\n\n/**\n * Deep merge two objects\n *\n * @param target - The target object\n * @param source - The source object\n * @param options - The options object\n * @returns The merged object\n */\nexport function deepMerge<X = any | any[], Y = any | any[], Z = X & Y>(\n  target: X,\n  source: Y,\n  options?: Partial<DeepMergeOptions>\n): Z {\n  if (!target || !source) {\n    return (target || source) as Z;\n  }\n\n  const opts = (options ?? {}) as DeepMergeOptions;\n  opts.arrayMerge ??= defaultArrayMerge;\n  opts.isMergeableObject ??= isMergeableObject;\n  // cloneUnlessOtherwiseSpecified is added to `options` so that custom arrayMerge()\n  // implementations can use it. The caller may not replace it.\n  opts.cloneUnlessOtherwiseSpecified ??= cloneUnlessOtherwiseSpecified;\n\n  const sourceIsArray = Array.isArray(source);\n  const targetIsArray = Array.isArray(target);\n  const sourceAndTargetTypesMatch = sourceIsArray === targetIsArray;\n\n  if (!sourceAndTargetTypesMatch) {\n    return cloneUnlessOtherwiseSpecified(source, opts);\n  }\n  if (sourceIsArray) {\n    return opts.arrayMerge(target as any[], source, opts);\n  }\n  return mergeObject(target, source, opts) as Z;\n}\n\ndeepMerge.all = function deepMergeAll(array: any[], options?: any) {\n  if (!Array.isArray(array)) {\n    throw new TypeError(\"first argument should be an array\");\n  }\n\n  return array.reduce((prev, next) => {\n    return deepMerge(prev, next, options);\n  }, {});\n};\n"],"mappings":";;;;;AAsBA,MAAM,eAAe,QAAa;AAChC,QAAO,MAAM,QAAQ,IAAI,GAAG,EAAE,GAAG,EAAE;;AAGrC,MAAM,iCACJ,OACA,YAIG;AACH,QAAO,QAAQ,UAAU,SAAS,QAAQ,kBAAkB,MAAM,GAC9D,UAAU,YAAY,MAAM,EAAE,OAAO,QAAQ,GAC7C;;AAGN,MAAM,qBAAqB,QAAe,QAAe,YAAkB;AACzE,QAAO,CAAC,GAAG,QAAQ,GAAG,OAAO,CAAC,KAAI,YAAW;AAC3C,SAAO,8BAA8B,SAAS,QAAQ;GACtD;;AAGJ,MAAM,oBACJ,KACA,YAGG;AACH,KAAI,CAAC,QAAQ,YACX,QAAO;CAET,MAAM,cAAc,QAAQ,YAAY,IAAI;AAE5C,QAAO,WAAW,YAAY,GAAG,cAAc;;AAGjD,MAAM,WAAW,WAAgC;AAC/C,QAAO,CACL,GAAG,OAAO,KAAK,OAAO,EACtB,GAAK,OAAO,wBACR,OAAO,sBAAsB,OAAO,CAAC,QAAO,WAAU;AACpD,SAAO,OAAO,qBAAqB,KAAK,QAAQ,OAAO;GACvD,GACF,EAAE,CACP;;AAGH,MAAM,eACJ,QACA,QACA,YAYG;CACH,MAAMA,cAAmC,EAAE;AAC3C,KAAI,QAAQ,kBAAkB,OAAO,CACnC,MAAK,MAAM,OAAO,QAAQ,OAAO,CAC/B,aAAY,OAAO,8BAA8B,OAAO,MAAM,QAAQ;AAG1E,MAAK,MAAM,OAAO,QAAQ,OAAO,CAC/B,aAAY,OACV,eAAe,QAAQ,IAAI,IAAI,QAAQ,kBAAkB,OAAO,KAAK,GACjE,iBAAiB,KAAK,QAAQ,CAAC,OAAO,MAAM,OAAO,MAAM,QAAQ,GACjE,8BAA8B,OAAO,MAAM,QAAQ;AAE3D,QAAO;;;;;;;;;;AAyBT,SAAgB,UACd,QACA,QACA,SACG;AACH,KAAI,CAAC,UAAU,CAAC,OACd,QAAQ,UAAU;CAGpB,MAAM,OAAQ,WAAW,EAAE;AAC3B,MAAK,eAAe;AACpB,MAAK,sBAAsB;AAG3B,MAAK,kCAAkC;CAEvC,MAAM,gBAAgB,MAAM,QAAQ,OAAO;AAI3C,KAAI,EAF8B,kBADZ,MAAM,QAAQ,OAAO,EAIzC,QAAO,8BAA8B,QAAQ,KAAK;AAEpD,KAAI,cACF,QAAO,KAAK,WAAW,QAAiB,QAAQ,KAAK;AAEvD,QAAO,YAAY,QAAQ,QAAQ,KAAK;;AAG1C,UAAU,MAAM,SAAS,aAAa,OAAc,SAAe;AACjE,KAAI,CAAC,MAAM,QAAQ,MAAM,CACvB,OAAM,IAAI,UAAU,oCAAoC;AAG1D,QAAO,MAAM,QAAQ,MAAM,SAAS;AAClC,SAAO,UAAU,MAAM,MAAM,QAAQ;IACpC,EAAE,CAAC"}

package/dist/delay.cjs

@@ -1 +1,90 @@
-const e=require(`./errors.cjs`);async function t(t,{signal:n}={}){return new Promise((r,i)=>{let a=()=>{i(new e.AbortError)},o=()=>{clearTimeout(s),a()};if(n?.aborted)return a();let s=setTimeout(r,t);n?.addEventListener(`abort`,o,{once:!0})})}async function n(e,n){return t(e,n)}exports.delay=t,exports.sleep=n;
+const require_errors = require('./errors.cjs');
+
+//#region src/delay.ts
+/**
+* Delays the execution of code for a specified number of milliseconds.
+*
+* This function returns a Promise that resolves after the specified delay, allowing you to use it
+* with async/await to pause execution.
+*
+* @example
+* ```typescript
+* async function foo() {
+*   console.log('Start');
+*   await delay(1000); // Delays execution for 1 second
+*   console.log('End');
+* }
+*
+* foo();
+*
+* // With AbortSignal
+* const controller = new AbortController();
+* const { signal } = controller;
+*
+* setTimeout(() => controller.abort(), 50); // Will cancel the delay after 50ms
+* try {
+*   await delay(100, { signal });
+*  } catch (error) {
+*   console.error(error); // Will log 'AbortError'
+*  }
+* }
+* ```
+*
+* @param ms - The number of milliseconds to delay.
+* @param options - The options object.
+* @returns A Promise that resolves after the specified delay.
+*/
+async function delay(ms, { signal } = {}) {
+	return new Promise((resolve, reject) => {
+		const abortError = () => {
+			reject(new require_errors.AbortError());
+		};
+		const abortHandler = () => {
+			clearTimeout(timeoutId);
+			abortError();
+		};
+		if (signal?.aborted) return abortError();
+		const timeoutId = setTimeout(resolve, ms);
+		signal?.addEventListener("abort", abortHandler, { once: true });
+	});
+}
+/**
+* Delays the execution of code for a specified number of milliseconds.
+*
+* This function returns a Promise that resolves after the specified delay, allowing you to use it
+* with async/await to pause execution.
+*
+* @example
+* ```typescript
+* async function foo() {
+*   console.log('Start');
+*   await sleep(1000); // Delays execution for 1 second
+*   console.log('End');
+* }
+*
+* foo();
+*
+* // With AbortSignal
+* const controller = new AbortController();
+* const { signal } = controller;
+*
+* setTimeout(() => controller.abort(), 50); // Will cancel the delay after 50ms
+* try {
+*   await sleep(100, { signal });
+*  } catch (error) {
+*   console.error(error); // Will log 'AbortError'
+*  }
+* }
+* ```
+*
+* @param ms - The number of milliseconds to sleep.
+* @param options - The options object.
+* @returns A Promise that resolves after the specified sleep.
+*/
+async function sleep(ms, options) {
+	return delay(ms, options);
+}
+
+//#endregion
+exports.delay = delay;
+exports.sleep = sleep;

package/dist/delay.mjs

@@ -1,2 +1,90 @@
-import{AbortError as e}from"./errors.mjs";async function t(t,{signal:n}={}){return new Promise((r,i)=>{let a=()=>{i(new e)},o=()=>{clearTimeout(s),a()};if(n?.aborted)return a();let s=setTimeout(r,t);n?.addEventListener(`abort`,o,{once:!0})})}async function n(e,n){return t(e,n)}export{t as delay,n as sleep};
+import { AbortError } from "./errors.mjs";
+
+//#region src/delay.ts
+/**
+* Delays the execution of code for a specified number of milliseconds.
+*
+* This function returns a Promise that resolves after the specified delay, allowing you to use it
+* with async/await to pause execution.
+*
+* @example
+* ```typescript
+* async function foo() {
+*   console.log('Start');
+*   await delay(1000); // Delays execution for 1 second
+*   console.log('End');
+* }
+*
+* foo();
+*
+* // With AbortSignal
+* const controller = new AbortController();
+* const { signal } = controller;
+*
+* setTimeout(() => controller.abort(), 50); // Will cancel the delay after 50ms
+* try {
+*   await delay(100, { signal });
+*  } catch (error) {
+*   console.error(error); // Will log 'AbortError'
+*  }
+* }
+* ```
+*
+* @param ms - The number of milliseconds to delay.
+* @param options - The options object.
+* @returns A Promise that resolves after the specified delay.
+*/
+async function delay(ms, { signal } = {}) {
+	return new Promise((resolve, reject) => {
+		const abortError = () => {
+			reject(new AbortError());
+		};
+		const abortHandler = () => {
+			clearTimeout(timeoutId);
+			abortError();
+		};
+		if (signal?.aborted) return abortError();
+		const timeoutId = setTimeout(resolve, ms);
+		signal?.addEventListener("abort", abortHandler, { once: true });
+	});
+}
+/**
+* Delays the execution of code for a specified number of milliseconds.
+*
+* This function returns a Promise that resolves after the specified delay, allowing you to use it
+* with async/await to pause execution.
+*
+* @example
+* ```typescript
+* async function foo() {
+*   console.log('Start');
+*   await sleep(1000); // Delays execution for 1 second
+*   console.log('End');
+* }
+*
+* foo();
+*
+* // With AbortSignal
+* const controller = new AbortController();
+* const { signal } = controller;
+*
+* setTimeout(() => controller.abort(), 50); // Will cancel the delay after 50ms
+* try {
+*   await sleep(100, { signal });
+*  } catch (error) {
+*   console.error(error); // Will log 'AbortError'
+*  }
+* }
+* ```
+*
+* @param ms - The number of milliseconds to sleep.
+* @param options - The options object.
+* @returns A Promise that resolves after the specified sleep.
+*/
+async function sleep(ms, options) {
+	return delay(ms, options);
+}
+
+//#endregion
+export { delay, sleep };
 //# sourceMappingURL=delay.mjs.map

package/dist/delay.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"delay.mjs","names":[],"sources":["../src/delay.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { AbortError } from \"./errors\";\n\ninterface DelayOptions {\n  signal?: AbortSignal;\n}\n\n/**\n * Delays the execution of code for a specified number of milliseconds.\n *\n * This function returns a Promise that resolves after the specified delay, allowing you to use it\n * with async/await to pause execution.\n *\n * @example\n * ```typescript\n * async function foo() {\n *   console.log('Start');\n *   await delay(1000); // Delays execution for 1 second\n *   console.log('End');\n * }\n *\n * foo();\n *\n * // With AbortSignal\n * const controller = new AbortController();\n * const { signal } = controller;\n *\n * setTimeout(() => controller.abort(), 50); // Will cancel the delay after 50ms\n * try {\n *   await delay(100, { signal });\n *  } catch (error) {\n *   console.error(error); // Will log 'AbortError'\n *  }\n * }\n * ```\n *\n * @param ms - The number of milliseconds to delay.\n * @param options - The options object.\n * @returns A Promise that resolves after the specified delay.\n */\nexport async function delay(\n  ms: number,\n  { signal }: DelayOptions = {}\n): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const abortError = () => {\n      reject(new AbortError());\n    };\n\n    const abortHandler = () => {\n      // eslint-disable-next-line ts/no-use-before-define\n      clearTimeout(timeoutId);\n      abortError();\n    };\n\n    if (signal?.aborted) {\n      // eslint-disable-next-line no-promise-executor-return\n      return abortError();\n    }\n\n    const timeoutId = setTimeout(resolve, ms);\n\n    signal?.addEventListener(\"abort\", abortHandler, { once: true });\n  });\n}\n\n/**\n * Delays the execution of code for a specified number of milliseconds.\n *\n * This function returns a Promise that resolves after the specified delay, allowing you to use it\n * with async/await to pause execution.\n *\n * @example\n * ```typescript\n * async function foo() {\n *   console.log('Start');\n *   await sleep(1000); // Delays execution for 1 second\n *   console.log('End');\n * }\n *\n * foo();\n *\n * // With AbortSignal\n * const controller = new AbortController();\n * const { signal } = controller;\n *\n * setTimeout(() => controller.abort(), 50); // Will cancel the delay after 50ms\n * try {\n *   await sleep(100, { signal });\n *  } catch (error) {\n *   console.error(error); // Will log 'AbortError'\n *  }\n * }\n * ```\n *\n * @param ms - The number of milliseconds to sleep.\n * @param options - The options object.\n * @returns A Promise that resolves after the specified sleep.\n */\nexport async function sleep(ms: number, options?: DelayOptions): Promise<void> {\n  return delay(ms, options);\n}\n"],"mappings":"0CAyDA,eAAsB,EACpB,EACA,CAAE,UAAyB,EAAE,CACd,CACf,OAAO,IAAI,SAAS,EAAS,IAAW,CACtC,IAAM,MAAmB,CACvB,EAAO,IAAI,EAAa,EAGpB,MAAqB,CAEzB,aAAa,EAAU,CACvB,GAAY,EAGd,GAAI,GAAQ,QAEV,OAAO,GAAY,CAGrB,IAAM,EAAY,WAAW,EAAS,EAAG,CAEzC,GAAQ,iBAAiB,QAAS,EAAc,CAAE,KAAM,GAAM,CAAC,EAC/D,CAoCJ,eAAsB,EAAM,EAAY,EAAuC,CAC7E,OAAO,EAAM,EAAI,EAAQ"}
+{"version":3,"file":"delay.mjs","names":[],"sources":["../src/delay.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { AbortError } from \"./errors\";\n\ninterface DelayOptions {\n  signal?: AbortSignal;\n}\n\n/**\n * Delays the execution of code for a specified number of milliseconds.\n *\n * This function returns a Promise that resolves after the specified delay, allowing you to use it\n * with async/await to pause execution.\n *\n * @example\n * ```typescript\n * async function foo() {\n *   console.log('Start');\n *   await delay(1000); // Delays execution for 1 second\n *   console.log('End');\n * }\n *\n * foo();\n *\n * // With AbortSignal\n * const controller = new AbortController();\n * const { signal } = controller;\n *\n * setTimeout(() => controller.abort(), 50); // Will cancel the delay after 50ms\n * try {\n *   await delay(100, { signal });\n *  } catch (error) {\n *   console.error(error); // Will log 'AbortError'\n *  }\n * }\n * ```\n *\n * @param ms - The number of milliseconds to delay.\n * @param options - The options object.\n * @returns A Promise that resolves after the specified delay.\n */\nexport async function delay(\n  ms: number,\n  { signal }: DelayOptions = {}\n): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const abortError = () => {\n      reject(new AbortError());\n    };\n\n    const abortHandler = () => {\n      // eslint-disable-next-line ts/no-use-before-define\n      clearTimeout(timeoutId);\n      abortError();\n    };\n\n    if (signal?.aborted) {\n      // eslint-disable-next-line no-promise-executor-return\n      return abortError();\n    }\n\n    const timeoutId = setTimeout(resolve, ms);\n\n    signal?.addEventListener(\"abort\", abortHandler, { once: true });\n  });\n}\n\n/**\n * Delays the execution of code for a specified number of milliseconds.\n *\n * This function returns a Promise that resolves after the specified delay, allowing you to use it\n * with async/await to pause execution.\n *\n * @example\n * ```typescript\n * async function foo() {\n *   console.log('Start');\n *   await sleep(1000); // Delays execution for 1 second\n *   console.log('End');\n * }\n *\n * foo();\n *\n * // With AbortSignal\n * const controller = new AbortController();\n * const { signal } = controller;\n *\n * setTimeout(() => controller.abort(), 50); // Will cancel the delay after 50ms\n * try {\n *   await sleep(100, { signal });\n *  } catch (error) {\n *   console.error(error); // Will log 'AbortError'\n *  }\n * }\n * ```\n *\n * @param ms - The number of milliseconds to sleep.\n * @param options - The options object.\n * @returns A Promise that resolves after the specified sleep.\n */\nexport async function sleep(ms: number, options?: DelayOptions): Promise<void> {\n  return delay(ms, options);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyDA,eAAsB,MACpB,IACA,EAAE,WAAyB,EAAE,EACd;AACf,QAAO,IAAI,SAAS,SAAS,WAAW;EACtC,MAAM,mBAAmB;AACvB,UAAO,IAAI,YAAY,CAAC;;EAG1B,MAAM,qBAAqB;AAEzB,gBAAa,UAAU;AACvB,eAAY;;AAGd,MAAI,QAAQ,QAEV,QAAO,YAAY;EAGrB,MAAM,YAAY,WAAW,SAAS,GAAG;AAEzC,UAAQ,iBAAiB,SAAS,cAAc,EAAE,MAAM,MAAM,CAAC;GAC/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCJ,eAAsB,MAAM,IAAY,SAAuC;AAC7E,QAAO,MAAM,IAAI,QAAQ"}

package/dist/errors.cjs

@@ -1 +1,24 @@
-var e=class extends Error{constructor(e=`The operation was aborted`){super(e),this.name=`AbortError`}},t=class extends Error{constructor(e=`The operation was timed out`){super(e),this.name=`TimeoutError`}};exports.AbortError=e,exports.TimeoutError=t;
+
+//#region src/errors.ts
+/**
+* An error class representing an aborted operation.
+*/
+var AbortError = class extends Error {
+	constructor(message = "The operation was aborted") {
+		super(message);
+		this.name = "AbortError";
+	}
+};
+/**
+* An error class representing an timeout operation.
+*/
+var TimeoutError = class extends Error {
+	constructor(message = "The operation was timed out") {
+		super(message);
+		this.name = "TimeoutError";
+	}
+};
+
+//#endregion
+exports.AbortError = AbortError;
+exports.TimeoutError = TimeoutError;

package/dist/errors.mjs

@@ -1,2 +1,23 @@
-var e=class extends Error{constructor(e=`The operation was aborted`){super(e),this.name=`AbortError`}},t=class extends Error{constructor(e=`The operation was timed out`){super(e),this.name=`TimeoutError`}};export{e as AbortError,t as TimeoutError};
+//#region src/errors.ts
+/**
+* An error class representing an aborted operation.
+*/
+var AbortError = class extends Error {
+	constructor(message = "The operation was aborted") {
+		super(message);
+		this.name = "AbortError";
+	}
+};
+/**
+* An error class representing an timeout operation.
+*/
+var TimeoutError = class extends Error {
+	constructor(message = "The operation was timed out") {
+		super(message);
+		this.name = "TimeoutError";
+	}
+};
+
+//#endregion
+export { AbortError, TimeoutError };
 //# sourceMappingURL=errors.mjs.map

package/dist/errors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n/**\n * An error class representing an aborted operation.\n */\nexport class AbortError extends Error {\n  constructor(message = \"The operation was aborted\") {\n    super(message);\n    this.name = \"AbortError\";\n  }\n}\n\n/**\n * An error class representing an timeout operation.\n */\nexport class TimeoutError extends Error {\n  constructor(message = \"The operation was timed out\") {\n    super(message);\n    this.name = \"TimeoutError\";\n  }\n}\n"],"mappings":"AAqBA,IAAa,EAAb,cAAgC,KAAM,CACpC,YAAY,EAAU,4BAA6B,CACjD,MAAM,EAAQ,CACd,KAAK,KAAO,eAOH,EAAb,cAAkC,KAAM,CACtC,YAAY,EAAU,8BAA+B,CACnD,MAAM,EAAQ,CACd,KAAK,KAAO"}
+{"version":3,"file":"errors.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n/**\n * An error class representing an aborted operation.\n */\nexport class AbortError extends Error {\n  constructor(message = \"The operation was aborted\") {\n    super(message);\n    this.name = \"AbortError\";\n  }\n}\n\n/**\n * An error class representing an timeout operation.\n */\nexport class TimeoutError extends Error {\n  constructor(message = \"The operation was timed out\") {\n    super(message);\n    this.name = \"TimeoutError\";\n  }\n}\n"],"mappings":";;;;AAqBA,IAAa,aAAb,cAAgC,MAAM;CACpC,YAAY,UAAU,6BAA6B;AACjD,QAAM,QAAQ;AACd,OAAK,OAAO;;;;;;AAOhB,IAAa,eAAb,cAAkC,MAAM;CACtC,YAAY,UAAU,+BAA+B;AACnD,QAAM,QAAQ;AACd,OAAK,OAAO"}

package/dist/filter-empty.cjs

@@ -1 +1,7 @@
-const e=require(`./type-checks/src/is-empty.cjs`),t=(t=[])=>t.filter(t=>!e.isEmpty(t));exports.filterEmpty=t;
+const require_is_empty = require('./type-checks/src/is-empty.cjs');
+
+//#region src/filter-empty.ts
+const filterEmpty = (values = []) => values.filter((value) => !require_is_empty.isEmpty(value));
+
+//#endregion
+exports.filterEmpty = filterEmpty;

package/dist/filter-empty.mjs

@@ -1,2 +1,8 @@
-import{isEmpty as e}from"./type-checks/src/is-empty.mjs";const t=(t=[])=>t.filter(t=>!e(t));export{t as filterEmpty};
+import { isEmpty } from "./type-checks/src/is-empty.mjs";
+
+//#region src/filter-empty.ts
+const filterEmpty = (values = []) => values.filter((value) => !isEmpty(value));
+
+//#endregion
+export { filterEmpty };
 //# sourceMappingURL=filter-empty.mjs.map

package/dist/filter-empty.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"filter-empty.mjs","names":[],"sources":["../src/filter-empty.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 License, and is\n free for commercial and private use. For more information, please visit\n our licensing page.\n\n Website:         https://stormsoftware.com\n Repository:      https://github.com/storm-software/stryke\n Documentation:   https://stormsoftware.com/projects/stryke/docs\n Contact:         https://stormsoftware.com/contact\n License:         https://stormsoftware.com/projects/stryke/license\n\n ------------------------------------------------------------------- */\n\nimport { isEmpty } from \"@stryke/type-checks/is-empty\";\n\nexport const filterEmpty = <T>(values: (T | null | undefined)[] = []): T[] =>\n  values.filter(value => !isEmpty(value)) as T[];\n"],"mappings":"yDAmBA,MAAa,GAAkB,EAAmC,EAAE,GAClE,EAAO,OAAO,GAAS,CAAC,EAAQ,EAAM,CAAC"}
+{"version":3,"file":"filter-empty.mjs","names":[],"sources":["../src/filter-empty.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 License, and is\n free for commercial and private use. For more information, please visit\n our licensing page.\n\n Website:         https://stormsoftware.com\n Repository:      https://github.com/storm-software/stryke\n Documentation:   https://stormsoftware.com/projects/stryke/docs\n Contact:         https://stormsoftware.com/contact\n License:         https://stormsoftware.com/projects/stryke/license\n\n ------------------------------------------------------------------- */\n\nimport { isEmpty } from \"@stryke/type-checks/is-empty\";\n\nexport const filterEmpty = <T>(values: (T | null | undefined)[] = []): T[] =>\n  values.filter(value => !isEmpty(value)) as T[];\n"],"mappings":";;;AAmBA,MAAa,eAAkB,SAAmC,EAAE,KAClE,OAAO,QAAO,UAAS,CAAC,QAAQ,MAAM,CAAC"}

package/dist/flatten-object.cjs

@@ -1 +1,48 @@
-const e=require(`./type-checks/src/is-plain-object.cjs`);function t(e){return n(e)}function n(t,r=``){let i={},a=Object.keys(t);for(let o of a){let a=t[o],s=r?`${r}.${o}`:o;if(e.isPlainObject(a)&&Object.keys(a).length>0)Object.assign(i,n(a,s));else if(Array.isArray(a))for(let[e,t]of a.entries())i[`${s}.${e}`]=t;else i[s]=a}return i}exports.flattenObject=t;
+const require_is_plain_object = require('./type-checks/src/is-plain-object.cjs');
+
+//#region src/flatten-object.ts
+/**
+* Flattens a nested object into a single level object with dot-separated keys.
+*
+* @example
+* ```typescript
+* const nestedObject = {
+*   a: {
+*     b: {
+*       c: 1
+*     }
+*   },
+*   d: [2, 3]
+* };
+*
+* const flattened = flattenObject(nestedObject);
+* console.log(flattened);
+* // Output:
+* // {
+* //   'a.b.c': 1,
+* //   'd.0': 2,
+* //   'd.1': 3
+* // }
+* ```
+*
+* @param object - The object to flatten.
+* @returns - The flattened object.
+*/
+function flattenObject(object) {
+	return flattenObjectImpl(object);
+}
+function flattenObjectImpl(object, prefix = "") {
+	const result = {};
+	const keys = Object.keys(object);
+	for (const key of keys) {
+		const value = object[key];
+		const prefixedKey = prefix ? `${prefix}.${key}` : key;
+		if (require_is_plain_object.isPlainObject(value) && Object.keys(value).length > 0) Object.assign(result, flattenObjectImpl(value, prefixedKey));
+		else if (Array.isArray(value)) for (const [index, element_] of value.entries()) result[`${prefixedKey}.${index}`] = element_;
+		else result[prefixedKey] = value;
+	}
+	return result;
+}
+
+//#endregion
+exports.flattenObject = flattenObject;

package/dist/flatten-object.mjs

@@ -1,2 +1,49 @@
-import{isPlainObject as e}from"./type-checks/src/is-plain-object.mjs";function t(e){return n(e)}function n(t,r=``){let i={},a=Object.keys(t);for(let o of a){let a=t[o],s=r?`${r}.${o}`:o;if(e(a)&&Object.keys(a).length>0)Object.assign(i,n(a,s));else if(Array.isArray(a))for(let[e,t]of a.entries())i[`${s}.${e}`]=t;else i[s]=a}return i}export{t as flattenObject};
+import { isPlainObject } from "./type-checks/src/is-plain-object.mjs";
+
+//#region src/flatten-object.ts
+/**
+* Flattens a nested object into a single level object with dot-separated keys.
+*
+* @example
+* ```typescript
+* const nestedObject = {
+*   a: {
+*     b: {
+*       c: 1
+*     }
+*   },
+*   d: [2, 3]
+* };
+*
+* const flattened = flattenObject(nestedObject);
+* console.log(flattened);
+* // Output:
+* // {
+* //   'a.b.c': 1,
+* //   'd.0': 2,
+* //   'd.1': 3
+* // }
+* ```
+*
+* @param object - The object to flatten.
+* @returns - The flattened object.
+*/
+function flattenObject(object) {
+	return flattenObjectImpl(object);
+}
+function flattenObjectImpl(object, prefix = "") {
+	const result = {};
+	const keys = Object.keys(object);
+	for (const key of keys) {
+		const value = object[key];
+		const prefixedKey = prefix ? `${prefix}.${key}` : key;
+		if (isPlainObject(value) && Object.keys(value).length > 0) Object.assign(result, flattenObjectImpl(value, prefixedKey));
+		else if (Array.isArray(value)) for (const [index, element_] of value.entries()) result[`${prefixedKey}.${index}`] = element_;
+		else result[prefixedKey] = value;
+	}
+	return result;
+}
+
+//#endregion
+export { flattenObject };
 //# sourceMappingURL=flatten-object.mjs.map

package/dist/flatten-object.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"flatten-object.mjs","names":[],"sources":["../src/flatten-object.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 License, and is\n free for commercial and private use. For more information, please visit\n our licensing page.\n\n Website:         https://stormsoftware.com\n Repository:      https://github.com/storm-software/stryke\n Documentation:   https://stormsoftware.com/projects/stryke/docs\n Contact:         https://stormsoftware.com/contact\n License:         https://stormsoftware.com/projects/stryke/license\n\n ------------------------------------------------------------------- */\n\nimport { isPlainObject } from \"@stryke/type-checks/is-plain-object\";\nimport type { DeepKey, DeepValue } from \"@stryke/types/object\";\n\n/**\n * Flattens a nested object into a single level object with dot-separated keys.\n *\n * @example\n * ```typescript\n * const nestedObject = {\n *   a: {\n *     b: {\n *       c: 1\n *     }\n *   },\n *   d: [2, 3]\n * };\n *\n * const flattened = flattenObject(nestedObject);\n * console.log(flattened);\n * // Output:\n * // {\n * //   'a.b.c': 1,\n * //   'd.0': 2,\n * //   'd.1': 3\n * // }\n * ```\n *\n * @param object - The object to flatten.\n * @returns - The flattened object.\n */\nexport function flattenObject<\n  TObject extends Record<string, any> = Record<string, any>,\n  TDeepKeyObject extends {\n    [TKey in DeepKey<TObject>]: DeepValue<TObject, TKey>;\n  } = { [TKey in DeepKey<TObject>]: DeepValue<TObject, TKey> }\n>(object: TObject): TDeepKeyObject {\n  return flattenObjectImpl<TObject, TDeepKeyObject>(object);\n}\n\nfunction flattenObjectImpl<\n  TObject extends Record<string, any> = Record<string, any>,\n  TDeepKeyObject extends {\n    [TKey in DeepKey<TObject>]: DeepValue<TObject, TKey>;\n  } = { [TKey in DeepKey<TObject>]: DeepValue<TObject, TKey> }\n>(object: TObject, prefix = \"\"): TDeepKeyObject {\n  const result = {} as TDeepKeyObject;\n  const keys = Object.keys(object);\n\n  for (const key of keys) {\n    const value = (object as any)[key];\n\n    const prefixedKey = prefix ? `${prefix}.${key}` : key;\n\n    if (isPlainObject(value) && Object.keys(value).length > 0) {\n      Object.assign(\n        result,\n        flattenObjectImpl<typeof value>(value, prefixedKey)\n      );\n    } else if (Array.isArray(value)) {\n      for (const [index, element_] of value.entries()) {\n        (result as any)[`${prefixedKey}.${index}` as DeepKey<TObject>] =\n          element_;\n      }\n    } else {\n      (result as any)[prefixedKey as DeepKey<TObject>] = value;\n    }\n  }\n\n  return result;\n}\n"],"mappings":"sEA+CA,SAAgB,EAKd,EAAiC,CACjC,OAAO,EAA2C,EAAO,CAG3D,SAAS,EAKP,EAAiB,EAAS,GAAoB,CAC9C,IAAM,EAAS,EAAE,CACX,EAAO,OAAO,KAAK,EAAO,CAEhC,IAAK,IAAM,KAAO,EAAM,CACtB,IAAM,EAAS,EAAe,GAExB,EAAc,EAAS,GAAG,EAAO,GAAG,IAAQ,EAElD,GAAI,EAAc,EAAM,EAAI,OAAO,KAAK,EAAM,CAAC,OAAS,EACtD,OAAO,OACL,EACA,EAAgC,EAAO,EAAY,CACpD,SACQ,MAAM,QAAQ,EAAM,CAC7B,IAAK,GAAM,CAAC,EAAO,KAAa,EAAM,SAAS,CAC5C,EAAe,GAAG,EAAY,GAAG,KAChC,OAGH,EAAe,GAAmC,EAIvD,OAAO"}
+{"version":3,"file":"flatten-object.mjs","names":[],"sources":["../src/flatten-object.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 License, and is\n free for commercial and private use. For more information, please visit\n our licensing page.\n\n Website:         https://stormsoftware.com\n Repository:      https://github.com/storm-software/stryke\n Documentation:   https://stormsoftware.com/projects/stryke/docs\n Contact:         https://stormsoftware.com/contact\n License:         https://stormsoftware.com/projects/stryke/license\n\n ------------------------------------------------------------------- */\n\nimport { isPlainObject } from \"@stryke/type-checks/is-plain-object\";\nimport type { DeepKey, DeepValue } from \"@stryke/types/object\";\n\n/**\n * Flattens a nested object into a single level object with dot-separated keys.\n *\n * @example\n * ```typescript\n * const nestedObject = {\n *   a: {\n *     b: {\n *       c: 1\n *     }\n *   },\n *   d: [2, 3]\n * };\n *\n * const flattened = flattenObject(nestedObject);\n * console.log(flattened);\n * // Output:\n * // {\n * //   'a.b.c': 1,\n * //   'd.0': 2,\n * //   'd.1': 3\n * // }\n * ```\n *\n * @param object - The object to flatten.\n * @returns - The flattened object.\n */\nexport function flattenObject<\n  TObject extends Record<string, any> = Record<string, any>,\n  TDeepKeyObject extends {\n    [TKey in DeepKey<TObject>]: DeepValue<TObject, TKey>;\n  } = { [TKey in DeepKey<TObject>]: DeepValue<TObject, TKey> }\n>(object: TObject): TDeepKeyObject {\n  return flattenObjectImpl<TObject, TDeepKeyObject>(object);\n}\n\nfunction flattenObjectImpl<\n  TObject extends Record<string, any> = Record<string, any>,\n  TDeepKeyObject extends {\n    [TKey in DeepKey<TObject>]: DeepValue<TObject, TKey>;\n  } = { [TKey in DeepKey<TObject>]: DeepValue<TObject, TKey> }\n>(object: TObject, prefix = \"\"): TDeepKeyObject {\n  const result = {} as TDeepKeyObject;\n  const keys = Object.keys(object);\n\n  for (const key of keys) {\n    const value = (object as any)[key];\n\n    const prefixedKey = prefix ? `${prefix}.${key}` : key;\n\n    if (isPlainObject(value) && Object.keys(value).length > 0) {\n      Object.assign(\n        result,\n        flattenObjectImpl<typeof value>(value, prefixedKey)\n      );\n    } else if (Array.isArray(value)) {\n      for (const [index, element_] of value.entries()) {\n        (result as any)[`${prefixedKey}.${index}` as DeepKey<TObject>] =\n          element_;\n      }\n    } else {\n      (result as any)[prefixedKey as DeepKey<TObject>] = value;\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,SAAgB,cAKd,QAAiC;AACjC,QAAO,kBAA2C,OAAO;;AAG3D,SAAS,kBAKP,QAAiB,SAAS,IAAoB;CAC9C,MAAM,SAAS,EAAE;CACjB,MAAM,OAAO,OAAO,KAAK,OAAO;AAEhC,MAAK,MAAM,OAAO,MAAM;EACtB,MAAM,QAAS,OAAe;EAE9B,MAAM,cAAc,SAAS,GAAG,OAAO,GAAG,QAAQ;AAElD,MAAI,cAAc,MAAM,IAAI,OAAO,KAAK,MAAM,CAAC,SAAS,EACtD,QAAO,OACL,QACA,kBAAgC,OAAO,YAAY,CACpD;WACQ,MAAM,QAAQ,MAAM,CAC7B,MAAK,MAAM,CAAC,OAAO,aAAa,MAAM,SAAS,CAC7C,CAAC,OAAe,GAAG,YAAY,GAAG,WAChC;MAGJ,CAAC,OAAe,eAAmC;;AAIvD,QAAO"}

package/dist/get-field.cjs

@@ -1 +1,54 @@
-const e=require(`./type-checks/src/is-number.cjs`),t=require(`./convert/src/to-string-key.cjs`),n=require(`./type-checks/src/is-deep-key.cjs`),r=require(`./to-path.cjs`);function i(o,s,c){if(o===null)return c;switch(typeof s){case`string`:{let e=o[s];return e===void 0?n.isDeepKey(s)?i(o,r.toPath(s),c):c:e}case`number`:case`symbol`:{e.isNumber(s)&&(s=t.toStringKey(s));let n=Array.isArray(s)?void 0:o[s];return n===void 0?c:n}default:{if(Array.isArray(s))return a(o,s,c);s=Object.is(s?.valueOf(),-0)?`-0`:String(s);let e=o[s];return e===void 0?c:e}}}function a(e,t,n){if(t.length===0)return n;let r=e;for(let e of t){if(r===null)return n;r=r[e]}return r===void 0?n:r}exports.getField=i;
+const require_is_number = require('./type-checks/src/is-number.cjs');
+const require_to_string_key = require('./convert/src/to-string-key.cjs');
+const require_is_deep_key = require('./type-checks/src/is-deep-key.cjs');
+const require_to_path = require('./to-path.cjs');
+
+//#region src/get-field.ts
+/**
+* Retrieves the value at a given path from an object. If the resolved value is undefined, the defaultValue is returned instead.
+*
+* @param {unknown} object - The object to query.
+* @param {PropertyKey | readonly PropertyKey[]} path - The path of the property to get.
+* @param {unknown} [defaultValue] - The value returned if the resolved value is undefined.
+* @returns {any} - Returns the resolved value.
+*/
+function getField(object, path, defaultValue) {
+	if (object === null) return defaultValue;
+	switch (typeof path) {
+		case "string": {
+			const result = object[path];
+			if (result === void 0) {
+				if (require_is_deep_key.isDeepKey(path)) return getField(object, require_to_path.toPath(path), defaultValue);
+				return defaultValue;
+			}
+			return result;
+		}
+		case "number":
+		case "symbol": {
+			if (require_is_number.isNumber(path)) path = require_to_string_key.toStringKey(path);
+			const result = Array.isArray(path) ? void 0 : object[path];
+			if (result === void 0) return defaultValue;
+			return result;
+		}
+		default: {
+			if (Array.isArray(path)) return getWithPath(object, path, defaultValue);
+			path = Object.is(path?.valueOf(), -0) ? "-0" : String(path);
+			const result = object[path];
+			if (result === void 0) return defaultValue;
+			return result;
+		}
+	}
+}
+function getWithPath(object, path, defaultValue) {
+	if (path.length === 0) return defaultValue;
+	let current = object;
+	for (const element_ of path) {
+		if (current === null) return defaultValue;
+		current = current[element_];
+	}
+	if (current === void 0) return defaultValue;
+	return current;
+}
+
+//#endregion
+exports.getField = getField;

package/dist/get-field.mjs

@@ -1,2 +1,55 @@
-import{isNumber as e}from"./type-checks/src/is-number.mjs";import{toStringKey as t}from"./convert/src/to-string-key.mjs";import{isDeepKey as n}from"./type-checks/src/is-deep-key.mjs";import{toPath as r}from"./to-path.mjs";function i(o,s,c){if(o===null)return c;switch(typeof s){case`string`:{let e=o[s];return e===void 0?n(s)?i(o,r(s),c):c:e}case`number`:case`symbol`:{e(s)&&(s=t(s));let n=Array.isArray(s)?void 0:o[s];return n===void 0?c:n}default:{if(Array.isArray(s))return a(o,s,c);s=Object.is(s?.valueOf(),-0)?`-0`:String(s);let e=o[s];return e===void 0?c:e}}}function a(e,t,n){if(t.length===0)return n;let r=e;for(let e of t){if(r===null)return n;r=r[e]}return r===void 0?n:r}export{i as getField};
+import { isNumber } from "./type-checks/src/is-number.mjs";
+import { toStringKey } from "./convert/src/to-string-key.mjs";
+import { isDeepKey } from "./type-checks/src/is-deep-key.mjs";
+import { toPath } from "./to-path.mjs";
+
+//#region src/get-field.ts
+/**
+* Retrieves the value at a given path from an object. If the resolved value is undefined, the defaultValue is returned instead.
+*
+* @param {unknown} object - The object to query.
+* @param {PropertyKey | readonly PropertyKey[]} path - The path of the property to get.
+* @param {unknown} [defaultValue] - The value returned if the resolved value is undefined.
+* @returns {any} - Returns the resolved value.
+*/
+function getField(object, path, defaultValue) {
+	if (object === null) return defaultValue;
+	switch (typeof path) {
+		case "string": {
+			const result = object[path];
+			if (result === void 0) {
+				if (isDeepKey(path)) return getField(object, toPath(path), defaultValue);
+				return defaultValue;
+			}
+			return result;
+		}
+		case "number":
+		case "symbol": {
+			if (isNumber(path)) path = toStringKey(path);
+			const result = Array.isArray(path) ? void 0 : object[path];
+			if (result === void 0) return defaultValue;
+			return result;
+		}
+		default: {
+			if (Array.isArray(path)) return getWithPath(object, path, defaultValue);
+			path = Object.is(path?.valueOf(), -0) ? "-0" : String(path);
+			const result = object[path];
+			if (result === void 0) return defaultValue;
+			return result;
+		}
+	}
+}
+function getWithPath(object, path, defaultValue) {
+	if (path.length === 0) return defaultValue;
+	let current = object;
+	for (const element_ of path) {
+		if (current === null) return defaultValue;
+		current = current[element_];
+	}
+	if (current === void 0) return defaultValue;
+	return current;
+}
+
+//#endregion
+export { getField };
 //# sourceMappingURL=get-field.mjs.map