@isdk/util 0.3.6 → 0.3.7

package/docs/classes/Semaphore.md

@@ -6,7 +6,7 @@
 
 # Class: Semaphore
 
-Defined in: [src/async-semaphore.ts:372](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L372)
+Defined in: [src/async-semaphore.ts:377](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L377)
 
 A Semaphore implementation for managing concurrency in asynchronous operations.
 Semaphores allow a fixed number of resources to be accessed concurrently.
@@ -57,7 +57,7 @@ const data = await Promise.all(array.map(fetchData));
 
 > **new Semaphore**(`maxConcurrency`, `options?`): `Semaphore`
 
-Defined in: [src/async-semaphore.ts:390](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L390)
+Defined in: [src/async-semaphore.ts:395](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L395)
 
 Creates a semaphore object. The first argument is the maximum concurrently number and the second argument is optional.
 
@@ -87,7 +87,7 @@ The maximum number of callers allowed to acquire the semaphore concurrently.
 
 > `protected` **\_activeCount**: `number`
 
-Defined in: [src/async-semaphore.ts:97](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L97)
+Defined in: [src/async-semaphore.ts:97](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L97)
 
 #### Inherited from
 
@@ -99,7 +99,7 @@ Defined in: [src/async-semaphore.ts:97](https://github.com/isdk/util.js/blob/618
 
 > `protected` **emitter**: `EventEmitter`
 
-Defined in: [src/async-semaphore.ts:91](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L91)
+Defined in: [src/async-semaphore.ts:91](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L91)
 
 #### Inherited from
 
@@ -111,7 +111,7 @@ Defined in: [src/async-semaphore.ts:91](https://github.com/isdk/util.js/blob/618
 
 > `protected` **free**: [`Deque`](Deque.md)\<`any`\>
 
-Defined in: [src/async-semaphore.ts:374](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L374)
+Defined in: [src/async-semaphore.ts:379](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L379)
 
 #### Overrides
 
@@ -123,7 +123,7 @@ Defined in: [src/async-semaphore.ts:374](https://github.com/isdk/util.js/blob/61
 
 > `protected` **initTokenFn**: (`token?`) => `void`
 
-Defined in: [src/async-semaphore.ts:95](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L95)
+Defined in: [src/async-semaphore.ts:95](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L95)
 
 #### Parameters
 
@@ -145,7 +145,7 @@ Defined in: [src/async-semaphore.ts:95](https://github.com/isdk/util.js/blob/618
 
 > `readonly` **maxConcurrency**: `number`
 
-Defined in: [src/async-semaphore.ts:373](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L373)
+Defined in: [src/async-semaphore.ts:378](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L378)
 
 ***
 
@@ -153,7 +153,7 @@ Defined in: [src/async-semaphore.ts:373](https://github.com/isdk/util.js/blob/61
 
 > `protected` **paused**: `boolean`
 
-Defined in: [src/async-semaphore.ts:96](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L96)
+Defined in: [src/async-semaphore.ts:96](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L96)
 
 #### Inherited from
 
@@ -165,7 +165,7 @@ Defined in: [src/async-semaphore.ts:96](https://github.com/isdk/util.js/blob/618
 
 > `protected` `optional` **pauseFn**: () => `void`
 
-Defined in: [src/async-semaphore.ts:93](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L93)
+Defined in: [src/async-semaphore.ts:93](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L93)
 
 #### Returns
 
@@ -181,7 +181,7 @@ Defined in: [src/async-semaphore.ts:93](https://github.com/isdk/util.js/blob/618
 
 > `protected` `optional` **resumeFn**: () => `void`
 
-Defined in: [src/async-semaphore.ts:94](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L94)
+Defined in: [src/async-semaphore.ts:94](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L94)
 
 #### Returns
 
@@ -197,7 +197,7 @@ Defined in: [src/async-semaphore.ts:94](https://github.com/isdk/util.js/blob/618
 
 > `protected` **useDefaultTokens**: `boolean`
 
-Defined in: [src/async-semaphore.ts:92](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L92)
+Defined in: [src/async-semaphore.ts:92](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L92)
 
 #### Inherited from
 
@@ -209,7 +209,7 @@ Defined in: [src/async-semaphore.ts:92](https://github.com/isdk/util.js/blob/618
 
 > `readonly` **waiting**: [`Deque`](Deque.md)\<[`SemaphoreTaskItem`](../interfaces/SemaphoreTaskItem.md) \| `undefined`\>
 
-Defined in: [src/async-semaphore.ts:89](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L89)
+Defined in: [src/async-semaphore.ts:89](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L89)
 
 #### Inherited from
 
@@ -223,7 +223,7 @@ Defined in: [src/async-semaphore.ts:89](https://github.com/isdk/util.js/blob/618
 
 > **get** **activeCount**(): `number`
 
-Defined in: [src/async-semaphore.ts:318](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L318)
+Defined in: [src/async-semaphore.ts:323](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L323)
 
 Get the total count of all active operations.
 
@@ -249,7 +249,7 @@ The total count of active operations, including both waiting and ongoing tasks.
 
 > **get** **pendingCount**(): `number`
 
-Defined in: [src/async-semaphore.ts:327](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L327)
+Defined in: [src/async-semaphore.ts:332](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L332)
 
 Get the number of callers waiting on the semaphore, i.e. the number of pending promises.
 
@@ -269,7 +269,7 @@ The number of waiters in the waiting list.
 
 > **\_dispatchTask**(`task`, `options?`): `void`
 
-Defined in: [src/async-semaphore.ts:212](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L212)
+Defined in: [src/async-semaphore.ts:210](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L210)
 
 #### Parameters
 
@@ -295,7 +295,7 @@ Defined in: [src/async-semaphore.ts:212](https://github.com/isdk/util.js/blob/61
 
 > **\_newReleaser**(`options?`): [`BinarySemaphoreReleaserFunc`](../interfaces/BinarySemaphoreReleaserFunc.md)
 
-Defined in: [src/async-semaphore.ts:199](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L199)
+Defined in: [src/async-semaphore.ts:195](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L195)
 
 #### Parameters
 
@@ -317,7 +317,7 @@ Defined in: [src/async-semaphore.ts:199](https://github.com/isdk/util.js/blob/61
 
 > **abort**(`reason?`): `void`
 
-Defined in: [src/async-semaphore.ts:301](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L301)
+Defined in: [src/async-semaphore.ts:306](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L306)
 
 #### Parameters
 
@@ -339,7 +339,7 @@ Defined in: [src/async-semaphore.ts:301](https://github.com/isdk/util.js/blob/61
 
 > **acquire**(`options?`): `Promise`\<[`BinarySemaphoreReleaserFunc`](../interfaces/BinarySemaphoreReleaserFunc.md)\>
 
-Defined in: [src/async-semaphore.ts:243](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L243)
+Defined in: [src/async-semaphore.ts:244](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L244)
 
 Acquire a token from the semaphore, thus decrement the number of available execution slots. If initFn is not used then the return value of the function can be discarded.
 
@@ -365,7 +365,7 @@ A promise that resolves to a release function when a token is acquired. If the s
 
 > **drain**(): `Promise`\<`any`[]\>
 
-Defined in: [src/async-semaphore.ts:439](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L439)
+Defined in: [src/async-semaphore.ts:451](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L451)
 
 Drains the semaphore and returns all the initialized tokens in an array. Draining is an ideal way to ensure there are no pending async tasks, for example before a process will terminate.
 
@@ -383,7 +383,7 @@ Drains the semaphore and returns all the initialized tokens in an array. Drainin
 
 > **init**(`options`): `void`
 
-Defined in: [src/async-semaphore.ts:193](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L193)
+Defined in: [src/async-semaphore.ts:189](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L189)
 
 #### Parameters
 
@@ -405,7 +405,7 @@ Defined in: [src/async-semaphore.ts:193](https://github.com/isdk/util.js/blob/61
 
 > **initFree**(`options`): `void`
 
-Defined in: [src/async-semaphore.ts:408](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L408)
+Defined in: [src/async-semaphore.ts:413](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L413)
 
 #### Parameters
 
@@ -427,7 +427,7 @@ Defined in: [src/async-semaphore.ts:408](https://github.com/isdk/util.js/blob/61
 
 > **lock**(`options?`): `any`
 
-Defined in: [src/async-semaphore.ts:435](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L435)
+Defined in: [src/async-semaphore.ts:447](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L447)
 
 #### Parameters
 
@@ -449,7 +449,7 @@ Defined in: [src/async-semaphore.ts:435](https://github.com/isdk/util.js/blob/61
 
 > **onReleased**(`options?`): `void`
 
-Defined in: [src/async-semaphore.ts:177](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L177)
+Defined in: [src/async-semaphore.ts:173](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L173)
 
 #### Parameters
 
@@ -471,7 +471,7 @@ Defined in: [src/async-semaphore.ts:177](https://github.com/isdk/util.js/blob/61
 
 > **release**(`options?`): `void`
 
-Defined in: [src/async-semaphore.ts:288](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L288)
+Defined in: [src/async-semaphore.ts:293](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L293)
 
 Releases the semaphore, incrementing the number of free execution slots. If there are tasks in the waiting queue, the next task will be dispatched.
 
@@ -495,7 +495,7 @@ Releases the semaphore, incrementing the number of free execution slots. If ther
 
 > **tryAcquire**(`options?`): `any`
 
-Defined in: [src/async-semaphore.ts:416](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L416)
+Defined in: [src/async-semaphore.ts:424](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L424)
 
 Attempt to acquire a token from the semaphore, if one is available immediately. Otherwise, return undefined.
 
@@ -521,7 +521,7 @@ Returns a token if the semaphore is not full; otherwise, returns `undefined`.
 
 > **unlock**(`token?`): `void`
 
-Defined in: [src/async-semaphore.ts:431](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L431)
+Defined in: [src/async-semaphore.ts:443](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L443)
 
 #### Parameters
 

package/docs/classes/SignalGate.md

@@ -6,7 +6,7 @@
 
 # Class: SignalGate\<T\>
 
-Defined in: [src/async-signal-gate.ts:20](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-signal-gate.ts#L20)
+Defined in: [src/async-signal-gate.ts:20](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-signal-gate.ts#L20)
 
 An asynchronous signal gate that blocks operations until a signal is emitted.
 This class allows multiple awaiters to wait for a signal and resolves all pending promises with the emitted value.
@@ -46,7 +46,7 @@ valueGate.signal(42); // Must provide a number value
 
 > `protected` **\_isSignaled**: `boolean` = `false`
 
-Defined in: [src/async-signal-gate.ts:21](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-signal-gate.ts#L21)
+Defined in: [src/async-signal-gate.ts:21](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-signal-gate.ts#L21)
 
 ***
 
@@ -54,7 +54,7 @@ Defined in: [src/async-signal-gate.ts:21](https://github.com/isdk/util.js/blob/6
 
 > `protected` **\_signalValue**: `T` \| `undefined`
 
-Defined in: [src/async-signal-gate.ts:22](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-signal-gate.ts#L22)
+Defined in: [src/async-signal-gate.ts:22](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-signal-gate.ts#L22)
 
 ***
 
@@ -62,7 +62,7 @@ Defined in: [src/async-signal-gate.ts:22](https://github.com/isdk/util.js/blob/6
 
 > `protected` **waitQueue**: `object`[] = `[]`
 
-Defined in: [src/async-signal-gate.ts:23](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-signal-gate.ts#L23)
+Defined in: [src/async-signal-gate.ts:23](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-signal-gate.ts#L23)
 
 #### reject()
 
@@ -100,7 +100,7 @@ Defined in: [src/async-signal-gate.ts:23](https://github.com/isdk/util.js/blob/6
 
 > **get** **signaled**(): `boolean`
 
-Defined in: [src/async-signal-gate.ts:28](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-signal-gate.ts#L28)
+Defined in: [src/async-signal-gate.ts:28](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-signal-gate.ts#L28)
 
 ##### Returns
 
@@ -112,7 +112,7 @@ Defined in: [src/async-signal-gate.ts:28](https://github.com/isdk/util.js/blob/6
 
 > **abort**(`reason?`): `void`
 
-Defined in: [src/async-signal-gate.ts:65](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-signal-gate.ts#L65)
+Defined in: [src/async-signal-gate.ts:65](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-signal-gate.ts#L65)
 
 Aborts all pending waits, rejecting their promises with an error.
 This does **not** reset the signal state (the gate remains signaled or unsignaled).
@@ -135,7 +135,7 @@ The reason for aborting the waits.
 
 > **reset**(): `void`
 
-Defined in: [src/async-signal-gate.ts:53](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-signal-gate.ts#L53)
+Defined in: [src/async-signal-gate.ts:53](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-signal-gate.ts#L53)
 
 Resets the gate to its initial state, allowing a new signal to be emitted.
 
@@ -149,7 +149,7 @@ Resets the gate to its initial state, allowing a new signal to be emitted.
 
 > **signal**(`value?`): `void`
 
-Defined in: [src/async-signal-gate.ts:38](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-signal-gate.ts#L38)
+Defined in: [src/async-signal-gate.ts:38](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-signal-gate.ts#L38)
 
 Emits the signal with an optional value, resolving all pending [wait](#wait) promises.
 Subsequent calls have no effect until [reset](#reset) is called.
@@ -172,7 +172,7 @@ The value to emit with the signal (only required if T is not void).
 
 > **wait**(): `Promise`\<`T`\>
 
-Defined in: [src/async-signal-gate.ts:83](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-signal-gate.ts#L83)
+Defined in: [src/async-signal-gate.ts:83](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-signal-gate.ts#L83)
 
 Returns a promise that resolves with the emitted signal value.
 If called after the signal has been emitted, resolves immediately with the stored value.

package/docs/functions/RateLimit.md

@@ -8,7 +8,7 @@
 
 > **RateLimit**(`rps`, `__namedParameters?`): () => `Promise`\<`void`\>
 
-Defined in: [src/async-semaphore.ts:476](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L476)
+Defined in: [src/async-semaphore.ts:488](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L488)
 
 Creates a rate limiter function that blocks with a promise whenever the rate limit is hit and resolves the promise once the call rate is within the limit set by rps. The second argument is optional.
 

package/docs/functions/arrayHasAll.md

@@ -8,7 +8,7 @@
 
 > **arrayHasAll**\<`T`\>(`array`, `elements`): `boolean`
 
-Defined in: [src/array-has-all.ts:15](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/array-has-all.ts#L15)
+Defined in: [src/array-has-all.ts:15](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/array-has-all.ts#L15)
 
 Checks whether the provided array contains all of the specified elements.
 

package/docs/functions/extNameLevel.md

@@ -8,7 +8,7 @@
 
 > **extNameLevel**(`extName`): `number`
 
-Defined in: [src/filename.ts:189](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/filename.ts#L189)
+Defined in: [src/filename.ts:226](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/filename.ts#L226)
 
 Calculates the level of an extension name.
 

package/docs/functions/extractCodeBlock.md

@@ -0,0 +1,91 @@
+[**@isdk/util**](../README.md)
+
+***
+
+[@isdk/util](../globals.md) / extractCodeBlock
+
+# Function: extractCodeBlock()
+
+## Call Signature
+
+> **extractCodeBlock**(`text`, `lang?`): `string` \| [`CodeString`](../interfaces/CodeString.md)
+
+Defined in: [src/extract-code-block.ts:61](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/extract-code-block.ts#L61)
+
+Extracts fenced code block(s) from the input `text`, optionally filtered by language.
+
+This function supports both triple-backtick (```) and triple-tilde (~~~) fenced code block
+syntaxes as commonly used in Markdown.
+
+### Parameters
+
+#### text
+
+`string`
+
+The input string that may contain one or more fenced code blocks.
+
+#### lang?
+
+`string`
+
+Optional. The expected language identifier (case-insensitive). If omitted,
+              the last code block in the text is returned, irrespective of its language.
+
+### Returns
+
+`string` \| [`CodeString`](../interfaces/CodeString.md)
+
+The extracted code content as a [CodeString](../interfaces/CodeString.md) instance (with `lang` and `meta` properties)
+         if a matching code block is found, or as the original `text` if no match is found.
+
+### Example
+
+```ts
+const input = 'Intro\n```js\nconsole.log("hello");\n```\nOutro';
+const code = extractCodeBlock(input, 'js');
+console.log(code);        // 'console.log("hello");'
+console.log(code.lang);   // 'js'
+```
+
+## Call Signature
+
+> **extractCodeBlock**(`text`, `options?`): `string` \| [`CodeString`](../interfaces/CodeString.md) \| (`string` \| [`CodeString`](../interfaces/CodeString.md))[]
+
+Defined in: [src/extract-code-block.ts:85](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/extract-code-block.ts#L85)
+
+Extracts fenced code block(s) from the input `text` with options.
+
+### Parameters
+
+#### text
+
+`string`
+
+The input string that may contain one or more fenced code blocks.
+
+#### options?
+
+[`ExtractCodeBlockOptions`](../interfaces/ExtractCodeBlockOptions.md)
+
+Optional. Extraction options:
+                 - `lang`: Filter by language (case-insensitive).
+                 - `index`: The index of the block to extract. `-1` is the last one (default).
+                 - `all`: If `true`, returns an array of all matching blocks.
+
+### Returns
+
+`string` \| [`CodeString`](../interfaces/CodeString.md) \| (`string` \| [`CodeString`](../interfaces/CodeString.md))[]
+
+If `options.all` is true, returns an array of [CodeString](../interfaces/CodeString.md) or string.
+         Otherwise, returns a single [CodeString](../interfaces/CodeString.md) or the original `text` if no match is found at the specified index.
+
+### Example
+
+```ts
+const input = '```js\n1\n```\n```ts\n2\n```';
+// Get the first block
+const first = extractCodeBlock(input, { index: 0 }); // '1\n' (js)
+// Get all blocks
+const all = extractCodeBlock(input, { all: true }); // ['1\n' (js), '2\n' (ts)]
+```

package/docs/functions/filenameReservedRegex.md

@@ -8,7 +8,7 @@
 
 > **filenameReservedRegex**(): `RegExp`
 
-Defined in: [src/filename.ts:42](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/filename.ts#L42)
+Defined in: [src/filename.ts:44](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/filename.ts#L44)
 
 Returns a new regular expression instance for reserved filename characters with the 'g' flag.
 use this to reset the with global option

package/docs/functions/findPort.md

@@ -8,7 +8,7 @@
 
 > **findPort**(`port`, `portRetryCount?`): `Promise`\<`number`\>
 
-Defined in: [src/find-port.ts:3](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/find-port.ts#L3)
+Defined in: [src/find-port.ts:3](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/find-port.ts#L3)
 
 ## Parameters
 

package/docs/functions/getMultiLevelExtname.md

@@ -8,7 +8,7 @@
 
 > **getMultiLevelExtname**(`filename`, `level?`): `string`
 
-Defined in: [src/get-multi-level-extname.ts:9](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/get-multi-level-extname.ts#L9)
+Defined in: [src/get-multi-level-extname.ts:9](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/get-multi-level-extname.ts#L9)
 
 Retrieves multi-level file extension
 

package/docs/functions/glob.md

@@ -8,7 +8,7 @@
 
 > **glob**(`filepath`, `pattern`, `rootDir?`): `boolean` \| `undefined`
 
-Defined in: [src/glob.ts:29](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/glob.ts#L29)
+Defined in: [src/glob.ts:29](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/glob.ts#L29)
 
 Matches a file path against a list of glob patterns.
 

package/docs/functions/isStringIn.md

@@ -8,7 +8,7 @@
 
 > **isStringIn**(`str`, `arr`): `boolean`
 
-Defined in: [src/is-string-in.ts:17](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/is-string-in.ts#L17)
+Defined in: [src/is-string-in.ts:17](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/is-string-in.ts#L17)
 
 Checks if a given string exists within an array of strings or a single string.
 

package/docs/functions/isValidFilename.md

@@ -8,7 +8,7 @@
 
 > **isValidFilename**(`filename`): `boolean` \| `""`
 
-Defined in: [src/filename.ts:63](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/filename.ts#L63)
+Defined in: [src/filename.ts:65](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/filename.ts#L65)
 
 Validates if a given string is a valid filename.
 

package/docs/functions/isValidFilepath.md

@@ -8,7 +8,7 @@
 
 > **isValidFilepath**(`filepath`): `boolean`
 
-Defined in: [src/filename.ts:72](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/filename.ts#L72)
+Defined in: [src/filename.ts:82](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/filename.ts#L82)
 
 Validates whether the given filepath is valid.
 

package/docs/functions/normalizeIncludeFiles.md

@@ -8,7 +8,7 @@
 
 > **normalizeIncludeFiles**(`files?`, `defaultFiles?`): `string`[]
 
-Defined in: [src/include-files.ts:34](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/include-files.ts#L34)
+Defined in: [src/include-files.ts:34](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/include-files.ts#L34)
 
 Normalizes a list of file patterns for glob matching.
 

package/docs/functions/omitDeepBy.md

@@ -8,7 +8,7 @@
 
 > **omitDeepBy**\<`T`\>(`value`, `predicate`, `cache?`): `any`
 
-Defined in: [src/omit-deep-by.ts:92](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/omit-deep-by.ts#L92)
+Defined in: [src/omit-deep-by.ts:92](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/omit-deep-by.ts#L92)
 
 Recursively removes properties from an object or array that satisfy the given predicate condition.
 

package/docs/functions/omitEmptyDeep.md

@@ -8,7 +8,7 @@
 
 > **omitEmptyDeep**\<`T`\>(`value`, `omitFunc?`): `any`
 
-Defined in: [src/omit-empty-deep.ts:33](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/omit-empty-deep.ts#L33)
+Defined in: [src/omit-empty-deep.ts:33](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/omit-empty-deep.ts#L33)
 
 Deeply removes empty values from objects or arrays, supporting both string and Symbol keys.
 

package/docs/functions/parseFrontMatter.md

@@ -8,7 +8,7 @@
 
 > **parseFrontMatter**(`value`, `delimiter?`): `object`
 
-Defined in: [src/front-matter.ts:6](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/front-matter.ts#L6)
+Defined in: [src/front-matter.ts:6](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/front-matter.ts#L6)
 
 ## Parameters
 

package/docs/functions/parseYaml.md

@@ -8,7 +8,7 @@
 
 > **parseYaml**(`content`, `options?`): `any`
 
-Defined in: [src/yaml.ts:51](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/yaml.ts#L51)
+Defined in: [src/yaml.ts:66](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/yaml.ts#L66)
 
 Parses a YAML string into a JavaScript object with optional custom tags.
 

package/docs/functions/reControlCharsRegex.md

@@ -8,7 +8,7 @@
 
 > **reControlCharsRegex**(): `RegExp`
 
-Defined in: [src/filename.ts:50](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/filename.ts#L50)
+Defined in: [src/filename.ts:52](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/filename.ts#L52)
 
 Returns a new regular expression instance for control characters in a filename with the 'g' flag.
 

package/docs/functions/registerYamlTag.md

@@ -8,7 +8,7 @@
 
 > **registerYamlTag**(`tags`): `void`
 
-Defined in: [src/yaml.ts:23](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/yaml.ts#L23)
+Defined in: [src/yaml.ts:34](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/yaml.ts#L34)
 
 Registers custom YAML tags to be used in parsing and stringifying YAML content.
 

package/docs/functions/removeLeadingEmptyLines.md

@@ -8,7 +8,7 @@
 
 > **removeLeadingEmptyLines**(`text`): `string`
 
-Defined in: [src/remove-leading-empty-lines.ts:16](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/remove-leading-empty-lines.ts#L16)
+Defined in: [src/remove-leading-empty-lines.ts:16](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/remove-leading-empty-lines.ts#L16)
 
 Removes all leading empty lines or "#" comments line from the given string.
 

package/docs/functions/sanitizeFilename.md

@@ -8,7 +8,7 @@
 
 > **sanitizeFilename**(`filename`, `options?`): `string`
 
-Defined in: [src/filename.ts:97](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/filename.ts#L97)
+Defined in: [src/filename.ts:110](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/filename.ts#L110)
 
 Sanitizes a given filename by replacing invalid characters with a specified replacement character or a default.
 

package/docs/functions/sanitizeFilepath.md

@@ -8,7 +8,7 @@
 
 > **sanitizeFilepath**(`filepath`, `options?`): `string`
 
-Defined in: [src/filename.ts:149](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/filename.ts#L149)
+Defined in: [src/filename.ts:178](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/filename.ts#L178)
 
 Sanitizes each part of a file path and reassembles it, ensuring the path is valid according to provided options.
 

package/docs/functions/sleep.md

@@ -8,7 +8,7 @@
 
 > **sleep**(`ms`): `Promise`\<`void`\>
 
-Defined in: [src/sleep.ts:12](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/sleep.ts#L12)
+Defined in: [src/sleep.ts:12](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/sleep.ts#L12)
 
 Suspends execution for a specified number of milliseconds
 

package/docs/functions/stringifyYaml.md

@@ -8,7 +8,7 @@
 
 > **stringifyYaml**(`content`, `options?`): `string`
 
-Defined in: [src/yaml.ts:85](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/yaml.ts#L85)
+Defined in: [src/yaml.ts:103](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/yaml.ts#L103)
 
 Converts a JavaScript object into a YAML string with optional custom tags.
 

package/docs/functions/toCamelCase.md

@@ -8,7 +8,7 @@
 
 > **toCamelCase**(`str`): `string`
 
-Defined in: [src/to-camel-case.ts:17](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/to-camel-case.ts#L17)
+Defined in: [src/to-camel-case.ts:17](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/to-camel-case.ts#L17)
 
 Converts a string to camelCase.