@isdk/util 0.3.6 → 0.3.8

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/2279f0b4363625d4cd214e9bab0415d49b594498/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/2279f0b4363625d4cd214e9bab0415d49b594498/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/2279f0b4363625d4cd214e9bab0415d49b594498/src/to-camel-case.ts#L17)
 
 Converts a string to camelCase.
 

package/docs/functions/toCapitalCase.md

@@ -8,7 +8,7 @@
 
 > **toCapitalCase**(`str`): `string`
 
-Defined in: [src/to-capital-case.ts:17](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/to-capital-case.ts#L17)
+Defined in: [src/to-capital-case.ts:17](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/to-capital-case.ts#L17)
 
 Converts a string to capital case, where the first letter of each word is capitalized
 and the rest are in lowercase. Words are separated by spaces, hyphens, or underscores.

package/docs/functions/toPascalCase.md

@@ -8,7 +8,7 @@
 
 > **toPascalCase**(`str`): `string`
 
-Defined in: [src/to-pascal-case.ts:16](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/to-pascal-case.ts#L16)
+Defined in: [src/to-pascal-case.ts:16](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/to-pascal-case.ts#L16)
 
 Converts a string to PascalCase.
 

package/docs/functions/traverseFolder.md

@@ -8,7 +8,7 @@
 
 > **traverseFolder**(`directoryPath`, `fileHandler`): `Promise`\<`void`\>
 
-Defined in: [src/traverse-folder.ts:38](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/traverse-folder.ts#L38)
+Defined in: [src/traverse-folder.ts:44](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/traverse-folder.ts#L44)
 
 Traverses a folder asynchronously and applies a handler to each file or directory.
 

package/docs/functions/traverseFolderSync.md

@@ -8,7 +8,7 @@
 
 > **traverseFolderSync**(`directoryPath`, `fileHandler`): `void`
 
-Defined in: [src/traverse-folder.ts:76](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/traverse-folder.ts#L76)
+Defined in: [src/traverse-folder.ts:89](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/traverse-folder.ts#L89)
 
 Traverses a folder synchronously and applies a handler to each file or directory.
 

package/docs/functions/yieldExec.md

@@ -8,7 +8,7 @@
 
 > **yieldExec**(): `Promise`\<`void`\>
 
-Defined in: [src/sleep.ts:28](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/sleep.ts#L28)
+Defined in: [src/sleep.ts:28](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/sleep.ts#L28)
 
 Yields execution control to the event loop, allowing pending I/O operations
 and scheduled tasks to run before continuing.

package/docs/globals.md

@@ -19,6 +19,9 @@
 - [BinarySemaphoreOptions](interfaces/BinarySemaphoreOptions.md)
 - [BinarySemaphoreReleaseOptions](interfaces/BinarySemaphoreReleaseOptions.md)
 - [BinarySemaphoreReleaserFunc](interfaces/BinarySemaphoreReleaserFunc.md)
+- [CodeBlockSelectorPart](interfaces/CodeBlockSelectorPart.md)
+- [CodeString](interfaces/CodeString.md)
+- [ExtractCodeBlockOptions](interfaces/ExtractCodeBlockOptions.md)
 - [IncludeFiles](interfaces/IncludeFiles.md)
 - [LoadConfigFileOptions](interfaces/LoadConfigFileOptions.md)
 - [SanitizeFilenameOptions](interfaces/SanitizeFilenameOptions.md)
@@ -27,6 +30,7 @@
 
 ## Type Aliases
 
+- [CodeBlockCombinator](type-aliases/CodeBlockCombinator.md)
 - [SemaphoreIsReadyFuncType](type-aliases/SemaphoreIsReadyFuncType.md)
 - [StringifyFunc](type-aliases/StringifyFunc.md)
 - [TraverseFolderHandler](type-aliases/TraverseFolderHandler.md)
@@ -43,6 +47,8 @@
 
 - [arrayHasAll](functions/arrayHasAll.md)
 - [extNameLevel](functions/extNameLevel.md)
+- [extractCodeBlock](functions/extractCodeBlock.md)
+- [extractTopLevelCodeBlocks](functions/extractTopLevelCodeBlocks.md)
 - [filenameReservedRegex](functions/filenameReservedRegex.md)
 - [findPort](functions/findPort.md)
 - [getMultiLevelExtname](functions/getMultiLevelExtname.md)
@@ -53,6 +59,7 @@
 - [normalizeIncludeFiles](functions/normalizeIncludeFiles.md)
 - [omitDeepBy](functions/omitDeepBy.md)
 - [omitEmptyDeep](functions/omitEmptyDeep.md)
+- [parseCodeBlockSelector](functions/parseCodeBlockSelector.md)
 - [parseFrontMatter](functions/parseFrontMatter.md)
 - [parseYaml](functions/parseYaml.md)
 - [RateLimit](functions/RateLimit.md)

package/docs/interfaces/BinarySemaphoreAcquireOptions.md

@@ -6,7 +6,7 @@
 
 # Interface: BinarySemaphoreAcquireOptions
 
-Defined in: [src/async-semaphore.ts:28](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L28)
+Defined in: [src/async-semaphore.ts:28](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/async-semaphore.ts#L28)
 
 ## Extended by
 
@@ -22,4 +22,4 @@ Defined in: [src/async-semaphore.ts:28](https://github.com/isdk/util.js/blob/618
 
 > `optional` **signal**: `AbortSignal`
 
-Defined in: [src/async-semaphore.ts:29](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L29)
+Defined in: [src/async-semaphore.ts:29](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/async-semaphore.ts#L29)

package/docs/interfaces/BinarySemaphoreOptions.md

@@ -6,7 +6,7 @@
 
 # Interface: BinarySemaphoreOptions
 
-Defined in: [src/async-semaphore.ts:21](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L21)
+Defined in: [src/async-semaphore.ts:21](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/async-semaphore.ts#L21)
 
 ## Extended by
 
@@ -18,7 +18,7 @@ Defined in: [src/async-semaphore.ts:21](https://github.com/isdk/util.js/blob/618
 
 > `optional` **capacity**: `number`
 
-Defined in: [src/async-semaphore.ts:25](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L25)
+Defined in: [src/async-semaphore.ts:25](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/async-semaphore.ts#L25)
 
 ***
 
@@ -26,7 +26,7 @@ Defined in: [src/async-semaphore.ts:25](https://github.com/isdk/util.js/blob/618
 
 > `optional` **initFn**: () => `any`
 
-Defined in: [src/async-semaphore.ts:22](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L22)
+Defined in: [src/async-semaphore.ts:22](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/async-semaphore.ts#L22)
 
 #### Returns
 
@@ -38,7 +38,7 @@ Defined in: [src/async-semaphore.ts:22](https://github.com/isdk/util.js/blob/618
 
 > `optional` **pauseFn**: () => `void`
 
-Defined in: [src/async-semaphore.ts:23](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L23)
+Defined in: [src/async-semaphore.ts:23](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/async-semaphore.ts#L23)
 
 #### Returns
 
@@ -50,7 +50,7 @@ Defined in: [src/async-semaphore.ts:23](https://github.com/isdk/util.js/blob/618
 
 > `optional` **resumeFn**: () => `void`
 
-Defined in: [src/async-semaphore.ts:24](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L24)
+Defined in: [src/async-semaphore.ts:24](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/async-semaphore.ts#L24)
 
 #### Returns
 

package/docs/interfaces/BinarySemaphoreReleaseOptions.md

@@ -6,7 +6,7 @@
 
 # Interface: BinarySemaphoreReleaseOptions
 
-Defined in: [src/async-semaphore.ts:33](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L33)
+Defined in: [src/async-semaphore.ts:33](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/async-semaphore.ts#L33)
 
 ## Extended by
 
@@ -22,4 +22,4 @@ Defined in: [src/async-semaphore.ts:33](https://github.com/isdk/util.js/blob/618
 
 > `optional` **token**: `any`
 
-Defined in: [src/async-semaphore.ts:34](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L34)
+Defined in: [src/async-semaphore.ts:34](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/async-semaphore.ts#L34)

package/docs/interfaces/BinarySemaphoreReleaserFunc.md

@@ -6,7 +6,7 @@
 
 # Interface: BinarySemaphoreReleaserFunc()
 
-Defined in: [src/async-semaphore.ts:38](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L38)
+Defined in: [src/async-semaphore.ts:38](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/async-semaphore.ts#L38)
 
 ## Extends
 
@@ -14,7 +14,7 @@ Defined in: [src/async-semaphore.ts:38](https://github.com/isdk/util.js/blob/618
 
 > **BinarySemaphoreReleaserFunc**(): `void`
 
-Defined in: [src/async-semaphore.ts:39](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L39)
+Defined in: [src/async-semaphore.ts:39](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/async-semaphore.ts#L39)
 
 ## Returns
 
@@ -30,7 +30,7 @@ Defined in: [src/async-semaphore.ts:39](https://github.com/isdk/util.js/blob/618
 
 > `optional` **token**: `any`
 
-Defined in: [src/async-semaphore.ts:34](https://github.com/isdk/util.js/blob/61856e5b1bbb9d976eeb1fdfe1a4d88a26997dec/src/async-semaphore.ts#L34)
+Defined in: [src/async-semaphore.ts:34](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/async-semaphore.ts#L34)
 
 #### Inherited from
 

package/docs/interfaces/CodeBlockSelectorPart.md

@@ -0,0 +1,36 @@
+[**@isdk/util**](../README.md)
+
+***
+
+[@isdk/util](../globals.md) / CodeBlockSelectorPart
+
+# Interface: CodeBlockSelectorPart
+
+Defined in: [src/extract-code-block.ts:38](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/extract-code-block.ts#L38)
+
+Represents a single segment in a code block selector path.
+
+A path like `md > ts` is parsed into two parts:
+1. `{ combinator: ' ', lang: 'md' }`
+2. `{ combinator: '>', lang: 'ts' }`
+
+## Properties
+
+### combinator
+
+> **combinator**: [`CodeBlockCombinator`](../type-aliases/CodeBlockCombinator.md)
+
+Defined in: [src/extract-code-block.ts:43](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/extract-code-block.ts#L43)
+
+The relationship to the previous segment in the path.
+For the first segment, ' ' usually implies a search in the root context.
+
+***
+
+### lang
+
+> **lang**: `string`
+
+Defined in: [src/extract-code-block.ts:47](https://github.com/isdk/util.js/blob/2279f0b4363625d4cd214e9bab0415d49b594498/src/extract-code-block.ts#L47)
+
+The target language identifier or alias to match.