@ts-utilities/core 1.0.1 → 1.0.2

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2025, Sohan Emon
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -1,46 +1,282 @@
 # @ts-utilities/core
 
-Core utilities for JavaScript/TypeScript projects, including React Native.
+![npm version](https://img.shields.io/npm/v/@ts-utilities/core)
+![npm downloads](https://img.shields.io/npm/dm/@ts-utilities/core)
+![License](https://img.shields.io/npm/l/@ts-utilities/core)
+![Tests](https://github.com/sohanemon/core/actions/workflows/test.yml/badge.svg)
+
+## Description
+
+`@ts-utilities/core` is a collection of core utility functions and advanced TypeScript types designed for JavaScript/TypeScript projects. It provides essential utilities for object manipulation, async operations, data transformation, and type-level programming. The library is built with TypeScript and is fully typed, ensuring a smooth and error-free development experience.
+
+## Features
+
+- **Object Utilities**: Functions to access and manipulate nested object properties
+- **Data Transformation**: Deep merging, null-to-undefined conversion, and more
+- **Async Operations**: Polling, scheduling, debouncing, throttling, and safe async execution
+- **General Utilities**: Debounce, throttle, sleep, printf, and other common utilities
+- **TypeScript Types**: Advanced utility types for deep partials, guards, and type-level logic gates
+- **React Native Compatible**: All utilities are platform-agnostic and work in React Native environments
 
 ## Installation
 
+You can install `@ts-utilities/core` using npm or yarn:
+
 ```bash
 npm install @ts-utilities/core
 ```
 
+or
+
+```bash
+yarn add @ts-utilities/core
+```
+
 ## Usage
 
-```ts
-import { deepmerge, debounce, sleep } from '@ts-utilities/core';
+### Importing Utilities
+
+You can import individual utilities or types as needed:
+
+```typescript
+import { deepmerge, poll, shield, sleep, debounce, throttle } from '@ts-utilities/core';
+import { getObjectValue, extendProps, hydrate } from '@ts-utilities/core/functions';
+import type { DeepPartial, Primitive, KeysOfType } from '@ts-utilities/core/types';
+```
+
+### Examples
+
+#### Object Utilities
+
+```typescript
+import { getObjectValue, extendProps } from '@ts-utilities/core';
+
+const obj = { a: { b: { c: 1 } } };
+const value = getObjectValue(obj, 'a.b.c'); // 1
+
+const extended = extendProps({ a: 1 }, { b: 'hello' }); // { a: 1, b: 'hello' }
+```
+
+#### Data Transformation
+
+```typescript
+import { hydrate, deepmerge } from '@ts-utilities/core';
+
+const cleaned = hydrate({ a: null, b: { c: null } }); // { a: undefined, b: { c: undefined } }
+
+// Deep merge objects
+const merged = deepmerge({ user: { name: 'John' } }, { user: { age: 30 } });
+// { user: { name: 'John', age: 30 } }
+
+// Compose functions automatically
+const composed = deepmerge(
+  { onFinish() { console.log('first') } },
+  { onFinish() { console.log('second') } },
+  { functionMerge: 'compose' }
+);
+// composed.onFinish() logs 'first' then 'second'
+
+// Merge functions with custom logic
+const combined = deepmerge(
+  { onFinish() { console.log('first') } },
+  { onFinish(v) { console.log('second', v) } },
+  {
+    customMerge: (key, target, source) => {
+      if (typeof target === 'function' && typeof source === 'function') {
+        return (...args) => { target(...args); source(...args); };
+      }
+      return source;
+    }
+  }
+);
+// combined.onFinish('done') logs 'first' then 'second done'
+```
+
+#### Async Operations
+
+```typescript
+import { poll, shield, sleep } from '@ts-utilities/core';
+
+const result = await poll(async () => {
+  const status = await checkStatus();
+  return status === 'ready' ? status : null;
+}, { interval: 2000, timeout: 30000 });
+
+const [error, data] = await shield(fetchData());
+```
+
+#### Debounce and Throttle
 
-// Example usage
-const merged = deepmerge({ a: 1 }, { b: 2 });
-const debouncedFn = debounce(() => console.log('called'), 300);
-await sleep(1000);
+```typescript
+import { debounce, throttle } from '@ts-utilities/core';
+
+const debouncedFunction = debounce(() => console.log('Debounced!'), 300);
+const throttledFunction = throttle(() => console.log('Throttled!'), 300);
+```
+
+#### TypeScript Types
+
+```typescript
+import type { DeepPartial, Nullable, KeysOfType, Primitive } from '@ts-utilities/core/types';
+
+type PartialUser = DeepPartial<User>;
+type NullableUser = Nullable<User>;
+type StringKeys = KeysOfType<User, string>;
 ```
 
-## What's Included
+## API Documentation
 
 ### Functions
 
-- **deepmerge**: Advanced object merging with circular reference detection
-- **hydrate**: Convert null values to undefined in data structures
-- **object**: Utilities for working with nested objects (getObjectValue, extendProps)
-- **poll**: Async polling with timeout and abort signal support
-- **schedule**: Background task execution with retry logic
-- **shield**: Safe error handling for sync/async operations
-- **utils**: General utilities (debounce, throttle, sleep, printf, etc.)
+#### Object Utilities
+```typescript
+getObjectValue<T, K extends Array<string | number>, D>(
+  obj: T,
+  path: K,
+  defaultValue: D
+): Exclude<GetValue<T, K>, undefined> | D;
+
+getObjectValue<T, K extends Array<string | number>>(
+  obj: T,
+  path: K
+): GetValue<T, K> | undefined;
+
+getObjectValue<T, S extends string, D>(
+  obj: T,
+  path: S,
+  defaultValue: D
+): Exclude<GetValue<T, SplitPath<S>>, undefined> | D;
+
+getObjectValue<T, S extends string>(
+  obj: T,
+  path: S
+): GetValue<T, SplitPath<S>> | undefined;
+
+extendProps<T, P extends object>(
+  base: T,
+  props: P
+): T extends null | undefined ? T : T & P;
+```
+
+#### Data Transformation
+```typescript
+hydrate<T>(data: T): Hydrate<T>
+
+deepmerge<T extends Record<string, any>, S extends Record<string, any>[]>(
+  target: T,
+  ...sources: S
+): TMerged<T | S[number]>
+
+deepmerge<T extends Record<string, any>, S extends Record<string, any>[]>(
+  target: T,
+  sources: S,
+  options?: DeepMergeOptions
+): TMerged<T | S[number]>
+```
+
+#### Async & Scheduling
+```typescript
+poll<T>(
+  cond: () => Promise<T | null | false | undefined>,
+  options?: {
+    interval?: number;
+    timeout?: number;
+    signal?: AbortSignal;
+    jitter?: boolean;
+  }
+): Promise<T>
+
+schedule(task: Task, options?: ScheduleOpts): void
+
+shield<T, E = Error>(operation: Promise<T>): Promise<[E | null, T | null]>
+shield<T, E = Error>(operation: () => T): [E | null, T | null]
+
+sleep(time?: number, signal?: AbortSignal): Promise<void>
+
+debounce<F extends (...args: any[]) => any>(
+  function_: F,
+  wait?: number,
+  options?: { immediate?: boolean }
+): DebouncedFunction<F>
+
+throttle<F extends (...args: any[]) => any>(
+  function_: F,
+  wait?: number,
+  options?: { leading?: boolean; trailing?: boolean }
+): ThrottledFunction<F>
+```
 
 ### Types
 
-- **gates**: Type-level logic gates (AND, OR, XOR, etc.)
-- **guards**: Type guards and primitive checks
-- **utilities**: Advanced TypeScript utilities (DeepPartial, KeysOfType, etc.)
+#### Utility Types
+```typescript
+Keys<T extends object>: keyof T
+Values<T extends object>: T[keyof T]
+DeepPartial<T>: T with all properties optional recursively
+SelectivePartial<T, K>: T with selected keys optional
+DeepRequired<T>: T with all properties required recursively
+SelectiveRequired<T, K>: T with selected keys required
+Never<T>: Object with never values
+Nullable<T>: T with null added to primitives
+Optional<T>: T with undefined added to primitives
+Nullish<T>: T with null|undefined added to primitives
+Maybe<T>: T with all properties optional and nullish
+DeepReadonly<T>: T with all properties readonly recursively
+Mutable<T>: T with readonly removed
+KeysOfType<T, U>: Keys of T where value is U
+OmitByType<T, U>: T without properties of type U
+RequiredKeys<T, K>: T with selected keys required
+Diff<T, U>: Properties in T or U but not both
+Intersection<T, U>: Common properties
+Merge<T, U>: Merged object
+Substract<T, U>: T without U properties
+AllOrNone<T>: T or empty object
+OneOf<T>: Union of single property objects
+TwoOf<T>: Union of two property objects
+Prettify<T>: Clean type representation
+NestedKeyOf<T>: All nested keys as strings
+Without<T, U>: T without U keys
+```
+
+#### Type Guards & Primitives
+```typescript
+Primitive: string | number | bigint | boolean | symbol | null | undefined
+Falsy: false | '' | 0 | null | undefined
+
+isFalsy(val: unknown): val is Falsy
+isNullish(val: unknown): val is nullish
+isPrimitive(val: unknown): val is Primitive
+isPlainObject(value: unknown): value is Record<string, any>
+```
+
+#### Logic Gates
+```typescript
+BUFFER<T>: T
+IMPLIES<T, U>: true if T extends U
+XOR_Binary<T, U>: T | U with exclusions
+XNOR_Binary<T, U>: T & U | neither
+AND<T extends any[]>: All true
+OR<T extends any[]>: At least one true
+XOR<T extends any[]>: Odd number true
+XNOR<T extends any[]>: Even number true
+NOT<T>: Never properties
+NAND<T extends any[]>: NOT AND
+NOR<T extends any[]>: NOT OR
+```
 
 ## React Native Compatibility
 
 This package is designed to work in React Native environments. All included utilities are platform-agnostic and don't depend on DOM APIs.
 
+## Contributing
+
+Contributions are welcome! Please read the [CONTRIBUTING.md](CONTRIBUTING.md) file for guidelines on how to contribute to the project.
+
 ## License
 
-ISC
+This project is licensed under the ISC License - see the [LICENSE](LICENSE) file for details.
+
+## Contact
+
+- **Sohan Emon**: [sohanemon@outlook.com](mailto:sohanemon@outlook.com)
+- **GitHub**: [sohanemon](https://github.com/sohanemon)

package/dist/functions/index.cjs

@@ -0,0 +1 @@
+require(`../types-Cr826iDM.cjs`);const e=require(`../functions-Bj4KwuS7.cjs`);exports.convertToNormalCase=e.i,exports.convertToSlug=e.a,exports.debounce=e.o,exports.deepmerge=e.h,exports.escapeRegExp=e.s,exports.extendProps=e.f,exports.getObjectValue=e.p,exports.hydrate=e.m,exports.normalizeText=e.c,exports.poll=e.r,exports.printf=e.l,exports.schedule=e.n,exports.shield=e.t,exports.sleep=e.u,exports.throttle=e.d;

package/dist/functions/index.d.cts

@@ -0,0 +1,2 @@
+import { _ as DeepMergeOptions, a as normalizeText, c as throttle, d as Task, f as schedule, g as hydrate, h as getObjectValue, i as escapeRegExp, l as shield, m as extendProps, n as convertToSlug, o as printf, p as poll, r as debounce, s as sleep, t as convertToNormalCase, u as ScheduleOpts, v as deepmerge } from "../index-CODZbfqn.cjs";
+export { DeepMergeOptions, ScheduleOpts, Task, convertToNormalCase, convertToSlug, debounce, deepmerge, escapeRegExp, extendProps, getObjectValue, hydrate, normalizeText, poll, printf, schedule, shield, sleep, throttle };

package/dist/functions/index.d.ts

@@ -0,0 +1,2 @@
+import { _ as DeepMergeOptions, a as normalizeText, c as throttle, d as Task, f as schedule, g as hydrate, h as getObjectValue, i as escapeRegExp, l as shield, m as extendProps, n as convertToSlug, o as printf, p as poll, r as debounce, s as sleep, t as convertToNormalCase, u as ScheduleOpts, v as deepmerge } from "../index-BlbkY6UJ.js";
+export { DeepMergeOptions, ScheduleOpts, Task, convertToNormalCase, convertToSlug, debounce, deepmerge, escapeRegExp, extendProps, getObjectValue, hydrate, normalizeText, poll, printf, schedule, shield, sleep, throttle };

package/dist/functions/index.js

@@ -0,0 +1 @@
+import"../types-CExAEo2W.js";import{a as e,c as t,d as n,f as r,h as i,i as a,l as o,m as s,n as c,o as l,p as u,r as d,s as f,t as p,u as m}from"../functions-DOWFQTb6.js";export{a as convertToNormalCase,e as convertToSlug,l as debounce,i as deepmerge,f as escapeRegExp,r as extendProps,u as getObjectValue,s as hydrate,t as normalizeText,d as poll,o as printf,c as schedule,p as shield,m as sleep,n as throttle};

package/dist/functions-Bj4KwuS7.cjs

@@ -0,0 +1 @@
+const e=require(`./types-Cr826iDM.cjs`);function t(t,...n){let r,i={},a=n[n.length-1];a&&typeof a==`object`&&!Array.isArray(a)&&(a.arrayMerge!==void 0||a.clone!==void 0||a.customMerge!==void 0||a.functionMerge!==void 0||a.maxDepth!==void 0)?(i={...i,...a},r=n.slice(0,-1)):r=n;let{arrayMerge:o=`replace`,clone:s=!0,functionMerge:c=`replace`,maxDepth:l=100,customMerge:u}=i,d=new WeakMap;return f(t,r,0);function f(t,n,r){if(r>=l)return console.warn(`[deepmerge] Maximum depth ${l} exceeded. Returning target as-is.`),t;if(!e.r(t)&&!Array.isArray(t)){for(let e of n)if(e!==void 0){if(u){let n=u(``,t,e);if(n!==void 0)return n}return typeof t==`function`&&typeof e==`function`&&c===`compose`?(...n)=>{t(...n),e(...n)}:e}return t}let i=s?Array.isArray(t)?[...t]:{...t}:t;for(let t of n)if(t!=null&&!d.has(t))if(d.set(t,i),Array.isArray(i)&&Array.isArray(t))i=p(i,t,o);else if(e.r(i)&&e.r(t)){let n=new Set([...Object.keys(i),...Object.keys(t),...Object.getOwnPropertySymbols(i),...Object.getOwnPropertySymbols(t)]);for(let a of n){let n=i[a],s=t[a];u&&u(a,n,s)!==void 0?i[a]=u(a,n,s):typeof n==`function`&&typeof s==`function`?c===`compose`?i[a]=(...e)=>{n(...e),s(...e)}:i[a]=s:e.r(n)&&e.r(s)?i[a]=f(n,[s],r+1):Array.isArray(n)&&Array.isArray(s)?i[a]=p(n,s,o):s!==void 0&&(i[a]=s)}}else i=t;return i}function p(t,n,r){if(typeof r==`function`)return r(t,n);switch(r){case`concat`:return[...t,...n];case`merge`:let r=Math.max(t.length,n.length),i=[];for(let a=0;a<r;a++)a<t.length&&a<n.length?e.r(t[a])&&e.r(n[a])?i[a]=f(t[a],[n[a]],0):i[a]=n[a]:a<t.length?i[a]=t[a]:i[a]=n[a];return i;case`replace`:default:return[...n]}}}function n(e){return r(e)}function r(t){if(t!==null){if(typeof t!=`object`||!t)return t;if(Array.isArray(t))return t.map(r);if(e.r(t)){let e={};for(let n in t)e[n]=r(t[n]);return e}return t}}function i(e,t,n){if(typeof t!=`string`&&!Array.isArray(t))return n;let r=(()=>Array.isArray(t)?t:t===``?[]:String(t).split(`.`).filter(e=>e!==``))();if(!Array.isArray(r))return n;let i=e;for(let e of r){if(i==null)return n;let t=typeof e==`string`&&Array.isArray(i)&&/^\d+$/.test(e)?Number.parseInt(e,10):e;i=i[t]}return i===void 0?n:i}function a(e,t){return e==null?e:Object.assign(e,t)}function o(e){return(e.split(`.`).pop()||e).replace(/([a-z])([A-Z])/g,`$1 $2`).split(/[-_|�\s]+/).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(` `)}const s=`àáãäâèéëêìíïîòóöôùúüûñç·/_,:;`,c=`aaaaaeeeeiiiioooouuuunc------`,l=e=>{if(typeof e!=`string`)throw TypeError(`Input must be a string`);let t=e.trim().toLowerCase(),n={};for(let e=0;e<29;e++)n[s.charAt(e)]=`aaaaaeeeeiiiioooouuuunc------`.charAt(e);return t=t.replace(RegExp(`[${s}]`,`g`),e=>n[e]||e),t.replace(/[^a-z0-9 -]/g,``).replace(/\s+/g,`-`).replace(/-+/g,`-`).replace(/^-+/,``).replace(/-+$/,``)||``},u=(e=1e3,t)=>new Promise(n=>{if(t?.aborted)return n();let r=setTimeout(()=>{a(),n()},e);function i(){clearTimeout(r),a(),n()}function a(){t?.removeEventListener(`abort`,i)}t&&t.addEventListener(`abort`,i,{once:!0})});function d(e,t=100,n){if(typeof e!=`function`)throw TypeError(`Expected the first parameter to be a function, got \`${typeof e}\`.`);if(t<0)throw RangeError("`wait` must not be negative.");let r=n?.immediate??!1,i,a,o,s;function c(){return s=e.apply(o,a),a=void 0,o=void 0,s}let l=function(...e){return a=e,o=this,i===void 0&&r&&(s=c.call(this)),i!==void 0&&clearTimeout(i),i=setTimeout(c.bind(this),t),s};return Object.defineProperty(l,`isPending`,{get(){return i!==void 0}}),l}function f(e,t=100,n){if(typeof e!=`function`)throw TypeError(`Expected the first parameter to be a function, got \`${typeof e}\`.`);if(t<0)throw RangeError("`wait` must not be negative.");let r=n?.leading??!0,i=n?.trailing??!0,a,o,s,c,l;function u(){c=Date.now(),l=e.apply(s,o),o=void 0,s=void 0}function d(){a=void 0,i&&o&&u()}let f=function(...e){let n=c?Date.now()-c:1/0;return o=e,s=this,n>=t?r?u():a=setTimeout(d,t):!a&&i&&(a=setTimeout(d,t-n)),l};return Object.defineProperty(f,`isPending`,{get(){return a!==void 0}}),f}function p(e,...t){let n=t.length===1&&Array.isArray(t[0])?t[0]:t,r=0;return e.replace(/%s/g,()=>{let e=n[r++];return e===void 0?``:String(e)})}function m(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}function h(e,t={}){if(!e)return``;let{lowercase:n=!0,removeAccents:r=!0,removeNonAlphanumeric:i=!0}=t,a=e.normalize(`NFC`);return r&&(a=a.normalize(`NFD`).replace(/\p{M}/gu,``)),i&&(a=a.replace(/^[^\p{L}\p{N}]*|[^\p{L}\p{N}]*$/gu,``)),n&&(a=a.toLocaleLowerCase()),a}async function g(e,{interval:t=5e3,timeout:n=300*1e3,jitter:r=!0,signal:i}={}){let a=Date.now(),o=i?.aborted??!1,s=()=>{o=!0};i?.addEventListener(`abort`,s,{once:!0});try{for(let s=0;;s++){if(o)throw Error(`Polling aborted`);let s=await e();if(s)return s;if(Date.now()-a>=n)throw Error(`Polling timed out`,{cause:`Polling timed out after ${n}ms`});await u(r?t+(Math.random()-.5)*t*.2:t,i)}}catch(e){throw e}finally{i?.removeEventListener(`abort`,s)}}function _(e,t={}){let{retry:n=0,delay:r=0}=t,i=Date.now(),a=async t=>{try{await e();let t=Date.now()-i;console.log(`⚡[schedule.ts] Completed in ${t}ms`)}catch(e){if(console.log(`⚡[schedule.ts] err:`,e),t>0)console.log(`⚡[schedule.ts] Retrying in ${r}ms...`),setTimeout(()=>a(t-1),r);else{let e=Date.now()-i;console.log(`⚡[schedule.ts] Failed after ${e}ms`)}}};setTimeout(()=>a(n),0)}function v(e){if(e instanceof Promise)return e.then(e=>[null,e]).catch(e=>[e,null]);try{return[null,e()]}catch(t){return console.log(`\x1b[31m🛡 [shield]\x1b[0m ${e.name} failed →`,t),[t,null]}}Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,`c`,{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,`d`,{enumerable:!0,get:function(){return f}}),Object.defineProperty(exports,`f`,{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,`h`,{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,`l`,{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,`m`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return d}}),Object.defineProperty(exports,`p`,{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,`u`,{enumerable:!0,get:function(){return u}});

package/dist/functions-DOWFQTb6.js

@@ -0,0 +1 @@
+import{r as e}from"./types-CExAEo2W.js";function t(t,...n){let r,i={},a=n[n.length-1];a&&typeof a==`object`&&!Array.isArray(a)&&(a.arrayMerge!==void 0||a.clone!==void 0||a.customMerge!==void 0||a.functionMerge!==void 0||a.maxDepth!==void 0)?(i={...i,...a},r=n.slice(0,-1)):r=n;let{arrayMerge:o=`replace`,clone:s=!0,functionMerge:c=`replace`,maxDepth:l=100,customMerge:u}=i,d=new WeakMap;return f(t,r,0);function f(t,n,r){if(r>=l)return console.warn(`[deepmerge] Maximum depth ${l} exceeded. Returning target as-is.`),t;if(!e(t)&&!Array.isArray(t)){for(let e of n)if(e!==void 0){if(u){let n=u(``,t,e);if(n!==void 0)return n}return typeof t==`function`&&typeof e==`function`&&c===`compose`?(...n)=>{t(...n),e(...n)}:e}return t}let i=s?Array.isArray(t)?[...t]:{...t}:t;for(let t of n)if(t!=null&&!d.has(t))if(d.set(t,i),Array.isArray(i)&&Array.isArray(t))i=p(i,t,o);else if(e(i)&&e(t)){let n=new Set([...Object.keys(i),...Object.keys(t),...Object.getOwnPropertySymbols(i),...Object.getOwnPropertySymbols(t)]);for(let a of n){let n=i[a],s=t[a];u&&u(a,n,s)!==void 0?i[a]=u(a,n,s):typeof n==`function`&&typeof s==`function`?c===`compose`?i[a]=(...e)=>{n(...e),s(...e)}:i[a]=s:e(n)&&e(s)?i[a]=f(n,[s],r+1):Array.isArray(n)&&Array.isArray(s)?i[a]=p(n,s,o):s!==void 0&&(i[a]=s)}}else i=t;return i}function p(t,n,r){if(typeof r==`function`)return r(t,n);switch(r){case`concat`:return[...t,...n];case`merge`:let r=Math.max(t.length,n.length),i=[];for(let a=0;a<r;a++)a<t.length&&a<n.length?e(t[a])&&e(n[a])?i[a]=f(t[a],[n[a]],0):i[a]=n[a]:a<t.length?i[a]=t[a]:i[a]=n[a];return i;case`replace`:default:return[...n]}}}function n(e){return r(e)}function r(t){if(t!==null){if(typeof t!=`object`||!t)return t;if(Array.isArray(t))return t.map(r);if(e(t)){let e={};for(let n in t)e[n]=r(t[n]);return e}return t}}function i(e,t,n){if(typeof t!=`string`&&!Array.isArray(t))return n;let r=(()=>Array.isArray(t)?t:t===``?[]:String(t).split(`.`).filter(e=>e!==``))();if(!Array.isArray(r))return n;let i=e;for(let e of r){if(i==null)return n;let t=typeof e==`string`&&Array.isArray(i)&&/^\d+$/.test(e)?Number.parseInt(e,10):e;i=i[t]}return i===void 0?n:i}function a(e,t){return e==null?e:Object.assign(e,t)}function o(e){return(e.split(`.`).pop()||e).replace(/([a-z])([A-Z])/g,`$1 $2`).split(/[-_|�\s]+/).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(` `)}const s=`àáãäâèéëêìíïîòóöôùúüûñç·/_,:;`,c=e=>{if(typeof e!=`string`)throw TypeError(`Input must be a string`);let t=e.trim().toLowerCase(),n={};for(let e=0;e<29;e++)n[s.charAt(e)]=`aaaaaeeeeiiiioooouuuunc------`.charAt(e);return t=t.replace(RegExp(`[${s}]`,`g`),e=>n[e]||e),t.replace(/[^a-z0-9 -]/g,``).replace(/\s+/g,`-`).replace(/-+/g,`-`).replace(/^-+/,``).replace(/-+$/,``)||``},l=(e=1e3,t)=>new Promise(n=>{if(t?.aborted)return n();let r=setTimeout(()=>{a(),n()},e);function i(){clearTimeout(r),a(),n()}function a(){t?.removeEventListener(`abort`,i)}t&&t.addEventListener(`abort`,i,{once:!0})});function u(e,t=100,n){if(typeof e!=`function`)throw TypeError(`Expected the first parameter to be a function, got \`${typeof e}\`.`);if(t<0)throw RangeError("`wait` must not be negative.");let r=n?.immediate??!1,i,a,o,s;function c(){return s=e.apply(o,a),a=void 0,o=void 0,s}let l=function(...e){return a=e,o=this,i===void 0&&r&&(s=c.call(this)),i!==void 0&&clearTimeout(i),i=setTimeout(c.bind(this),t),s};return Object.defineProperty(l,`isPending`,{get(){return i!==void 0}}),l}function d(e,t=100,n){if(typeof e!=`function`)throw TypeError(`Expected the first parameter to be a function, got \`${typeof e}\`.`);if(t<0)throw RangeError("`wait` must not be negative.");let r=n?.leading??!0,i=n?.trailing??!0,a,o,s,c,l;function u(){c=Date.now(),l=e.apply(s,o),o=void 0,s=void 0}function d(){a=void 0,i&&o&&u()}let f=function(...e){let n=c?Date.now()-c:1/0;return o=e,s=this,n>=t?r?u():a=setTimeout(d,t):!a&&i&&(a=setTimeout(d,t-n)),l};return Object.defineProperty(f,`isPending`,{get(){return a!==void 0}}),f}function f(e,...t){let n=t.length===1&&Array.isArray(t[0])?t[0]:t,r=0;return e.replace(/%s/g,()=>{let e=n[r++];return e===void 0?``:String(e)})}function p(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}function m(e,t={}){if(!e)return``;let{lowercase:n=!0,removeAccents:r=!0,removeNonAlphanumeric:i=!0}=t,a=e.normalize(`NFC`);return r&&(a=a.normalize(`NFD`).replace(/\p{M}/gu,``)),i&&(a=a.replace(/^[^\p{L}\p{N}]*|[^\p{L}\p{N}]*$/gu,``)),n&&(a=a.toLocaleLowerCase()),a}async function h(e,{interval:t=5e3,timeout:n=300*1e3,jitter:r=!0,signal:i}={}){let a=Date.now(),o=i?.aborted??!1,s=()=>{o=!0};i?.addEventListener(`abort`,s,{once:!0});try{for(let s=0;;s++){if(o)throw Error(`Polling aborted`);let s=await e();if(s)return s;if(Date.now()-a>=n)throw Error(`Polling timed out`,{cause:`Polling timed out after ${n}ms`});await l(r?t+(Math.random()-.5)*t*.2:t,i)}}catch(e){throw e}finally{i?.removeEventListener(`abort`,s)}}function g(e,t={}){let{retry:n=0,delay:r=0}=t,i=Date.now(),a=async t=>{try{await e();let t=Date.now()-i;console.log(`⚡[schedule.ts] Completed in ${t}ms`)}catch(e){if(console.log(`⚡[schedule.ts] err:`,e),t>0)console.log(`⚡[schedule.ts] Retrying in ${r}ms...`),setTimeout(()=>a(t-1),r);else{let e=Date.now()-i;console.log(`⚡[schedule.ts] Failed after ${e}ms`)}}};setTimeout(()=>a(n),0)}function _(e){if(e instanceof Promise)return e.then(e=>[null,e]).catch(e=>[e,null]);try{return[null,e()]}catch(t){return console.log(`\x1b[31m🛡 [shield]\x1b[0m ${e.name} failed →`,t),[t,null]}}export{c as a,m as c,d,a as f,t as h,o as i,f as l,n as m,g as n,u as o,i as p,h as r,p as s,_ as t,l as u};