@isdk/util 0.3.7 → 0.3.9

package/docs/functions/parseCodeBlockSelector.md

@@ -0,0 +1,34 @@
+[**@isdk/util**](../README.md)
+
+***
+
+[@isdk/util](../globals.md) / parseCodeBlockSelector
+
+# Function: parseCodeBlockSelector()
+
+> **parseCodeBlockSelector**(`lang?`): [`CodeBlockSelectorPart`](../interfaces/CodeBlockSelectorPart.md)[]
+
+Defined in: [src/extract-code-block.ts:160](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/extract-code-block.ts#L160)
+
+Parses a selector string into an array of structured [CodeBlockSelectorPart](../interfaces/CodeBlockSelectorPart.md) objects.
+
+## Parameters
+
+### lang?
+
+`string`
+
+The selector string.
+
+## Returns
+
+[`CodeBlockSelectorPart`](../interfaces/CodeBlockSelectorPart.md)[]
+
+An array of parsed selector parts.
+
+## Example
+
+```ts
+parseCodeBlockSelector('md > ts');
+// => [{combinator: ' ', lang: 'md'}, {combinator: '>', lang: 'ts'}]
+```

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/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/front-matter.ts#L6)
+Defined in: [src/front-matter.ts:6](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/front-matter.ts#L6)
 
 ## Parameters
 

package/docs/functions/parseYaml.md

@@ -8,7 +8,7 @@
 
 > **parseYaml**(`content`, `options?`): `any`
 
-Defined in: [src/yaml.ts:66](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/yaml.ts#L66)
+Defined in: [src/yaml.ts:66](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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:52](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/filename.ts#L52)
+Defined in: [src/filename.ts:52](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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:34](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/yaml.ts#L34)
+Defined in: [src/yaml.ts:34](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/remove-leading-empty-lines.ts#L16)
+Defined in: [src/remove-leading-empty-lines.ts:16](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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:110](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/filename.ts#L110)
+Defined in: [src/filename.ts:110](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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:178](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/filename.ts#L178)
+Defined in: [src/filename.ts:178](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/sleep.ts#L12)
+Defined in: [src/sleep.ts:12](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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:103](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/yaml.ts#L103)
+Defined in: [src/yaml.ts:103](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/to-camel-case.ts#L17)
+Defined in: [src/to-camel-case.ts:17](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/to-capital-case.ts#L17)
+Defined in: [src/to-capital-case.ts:17](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/to-pascal-case.ts#L16)
+Defined in: [src/to-pascal-case.ts:16](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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:44](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/traverse-folder.ts#L44)
+Defined in: [src/traverse-folder.ts:44](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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:89](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/traverse-folder.ts#L89)
+Defined in: [src/traverse-folder.ts:89](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/sleep.ts#L28)
+Defined in: [src/sleep.ts:28](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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,8 +19,10 @@
 - [BinarySemaphoreOptions](interfaces/BinarySemaphoreOptions.md)
 - [BinarySemaphoreReleaseOptions](interfaces/BinarySemaphoreReleaseOptions.md)
 - [BinarySemaphoreReleaserFunc](interfaces/BinarySemaphoreReleaserFunc.md)
+- [CodeBlockSelectorPart](interfaces/CodeBlockSelectorPart.md)
 - [CodeString](interfaces/CodeString.md)
 - [ExtractCodeBlockOptions](interfaces/ExtractCodeBlockOptions.md)
+- [FindPortOptions](interfaces/FindPortOptions.md)
 - [IncludeFiles](interfaces/IncludeFiles.md)
 - [LoadConfigFileOptions](interfaces/LoadConfigFileOptions.md)
 - [SanitizeFilenameOptions](interfaces/SanitizeFilenameOptions.md)
@@ -29,6 +31,7 @@
 
 ## Type Aliases
 
+- [CodeBlockCombinator](type-aliases/CodeBlockCombinator.md)
 - [SemaphoreIsReadyFuncType](type-aliases/SemaphoreIsReadyFuncType.md)
 - [StringifyFunc](type-aliases/StringifyFunc.md)
 - [TraverseFolderHandler](type-aliases/TraverseFolderHandler.md)
@@ -46,6 +49,7 @@
 - [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)
@@ -56,6 +60,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/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L28)
+Defined in: [src/async-semaphore.ts:28](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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/20d
 
 > `optional` **signal**: `AbortSignal`
 
-Defined in: [src/async-semaphore.ts:29](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L29)
+Defined in: [src/async-semaphore.ts:29](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L21)
+Defined in: [src/async-semaphore.ts:21](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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/20d
 
 > `optional` **capacity**: `number`
 
-Defined in: [src/async-semaphore.ts:25](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L25)
+Defined in: [src/async-semaphore.ts:25](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L25)
 
 ***
 
@@ -26,7 +26,7 @@ Defined in: [src/async-semaphore.ts:25](https://github.com/isdk/util.js/blob/20d
 
 > `optional` **initFn**: () => `any`
 
-Defined in: [src/async-semaphore.ts:22](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L22)
+Defined in: [src/async-semaphore.ts:22](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L22)
 
 #### Returns
 
@@ -38,7 +38,7 @@ Defined in: [src/async-semaphore.ts:22](https://github.com/isdk/util.js/blob/20d
 
 > `optional` **pauseFn**: () => `void`
 
-Defined in: [src/async-semaphore.ts:23](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L23)
+Defined in: [src/async-semaphore.ts:23](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L23)
 
 #### Returns
 
@@ -50,7 +50,7 @@ Defined in: [src/async-semaphore.ts:23](https://github.com/isdk/util.js/blob/20d
 
 > `optional` **resumeFn**: () => `void`
 
-Defined in: [src/async-semaphore.ts:24](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L24)
+Defined in: [src/async-semaphore.ts:24](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L33)
+Defined in: [src/async-semaphore.ts:33](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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/20d
 
 > `optional` **token**: `any`
 
-Defined in: [src/async-semaphore.ts:34](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L34)
+Defined in: [src/async-semaphore.ts:34](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L38)
+Defined in: [src/async-semaphore.ts:38](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L38)
 
 ## Extends
 
@@ -14,7 +14,7 @@ Defined in: [src/async-semaphore.ts:38](https://github.com/isdk/util.js/blob/20d
 
 > **BinarySemaphoreReleaserFunc**(): `void`
 
-Defined in: [src/async-semaphore.ts:39](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L39)
+Defined in: [src/async-semaphore.ts:39](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L39)
 
 ## Returns
 
@@ -30,7 +30,7 @@ Defined in: [src/async-semaphore.ts:39](https://github.com/isdk/util.js/blob/20d
 
 > `optional` **token**: `any`
 
-Defined in: [src/async-semaphore.ts:34](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L34)
+Defined in: [src/async-semaphore.ts:34](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/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/30c54a8a455a9593000448de2a45f94a197d73de/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/30c54a8a455a9593000448de2a45f94a197d73de/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/30c54a8a455a9593000448de2a45f94a197d73de/src/extract-code-block.ts#L47)
+
+The target language identifier or alias to match.

package/docs/interfaces/CodeString.md

@@ -6,7 +6,7 @@
 
 # Interface: CodeString
 
-Defined in: [src/extract-code-block.ts:9](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/extract-code-block.ts#L9)
+Defined in: [src/extract-code-block.ts:9](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/extract-code-block.ts#L9)
 
 An extension of the built-in `String` type that carries metadata about
 the extracted code block.
@@ -29,7 +29,7 @@ in the markdown fence.
 
 > `optional` **lang**: `string`
 
-Defined in: [src/extract-code-block.ts:14](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/extract-code-block.ts#L14)
+Defined in: [src/extract-code-block.ts:14](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/extract-code-block.ts#L14)
 
 The programming language identifier of the code block (e.g., 'ts', 'js').
 It is normalized to lowercase.
@@ -54,7 +54,7 @@ Returns the length of a String object.
 
 > `optional` **meta**: `string`
 
-Defined in: [src/extract-code-block.ts:18](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/extract-code-block.ts#L18)
+Defined in: [src/extract-code-block.ts:18](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/extract-code-block.ts#L18)
 
 Any additional metadata provided after the language identifier on the fence line.
 

package/docs/interfaces/ExtractCodeBlockOptions.md

@@ -6,7 +6,7 @@
 
 # Interface: ExtractCodeBlockOptions
 
-Defined in: [src/extract-code-block.ts:24](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/extract-code-block.ts#L24)
+Defined in: [src/extract-code-block.ts:53](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/extract-code-block.ts#L53)
 
 Options for extracting code blocks.
 
@@ -16,7 +16,7 @@ Options for extracting code blocks.
 
 > `optional` **all**: `boolean`
 
-Defined in: [src/extract-code-block.ts:38](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/extract-code-block.ts#L38)
+Defined in: [src/extract-code-block.ts:71](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/extract-code-block.ts#L71)
 
 Optional. If true, returns an array of all matching code blocks.
 
@@ -26,9 +26,9 @@ Optional. If true, returns an array of all matching code blocks.
 
 > `optional` **index**: `number`
 
-Defined in: [src/extract-code-block.ts:34](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/extract-code-block.ts#L34)
+Defined in: [src/extract-code-block.ts:67](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/extract-code-block.ts#L67)
 
-Optional. The 0-based index of the code block to extract.
+Optional. The 0-based index of the code block to extract from the final result set.
 Supports negative indexing: -1 means the last one, -2 means the second to last, etc.
 Defaults to -1.
 
@@ -38,6 +38,27 @@ Defaults to -1.
 
 > `optional` **lang**: `string`
 
-Defined in: [src/extract-code-block.ts:28](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/extract-code-block.ts#L28)
+Defined in: [src/extract-code-block.ts:61](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/extract-code-block.ts#L61)
 
-Optional. The expected language identifier (case-insensitive).
+Optional. The expected language identifier or a CSS-like selector path.
+Supports aliases (e.g., 'js' for 'javascript').
+
+#### Examples
+
+```ts
+'ts' - Find the last TypeScript block.
+```
+
+```ts
+'md > ts' - Find ts blocks inside md blocks.
+```
+
+***
+
+### langMap?
+
+> `optional` **langMap**: `Record`\<`string`, `string`\>
+
+Defined in: [src/extract-code-block.ts:75](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/extract-code-block.ts#L75)
+
+Optional. A map of language aliases to their normalized names.

package/docs/interfaces/FindPortOptions.md

@@ -0,0 +1,25 @@
+[**@isdk/util**](../README.md)
+
+***
+
+[@isdk/util](../globals.md) / FindPortOptions
+
+# Interface: FindPortOptions
+
+Defined in: [src/find-port.ts:3](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/find-port.ts#L3)
+
+## Properties
+
+### host?
+
+> `optional` **host**: `string`
+
+Defined in: [src/find-port.ts:5](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/find-port.ts#L5)
+
+***
+
+### retryCount?
+
+> `optional` **retryCount**: `number`
+
+Defined in: [src/find-port.ts:4](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/find-port.ts#L4)

package/docs/interfaces/IncludeFiles.md

@@ -6,7 +6,7 @@
 
 # Interface: IncludeFiles
 
-Defined in: [src/include-files.ts:6](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/include-files.ts#L6)
+Defined in: [src/include-files.ts:6](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/include-files.ts#L6)
 
 ## Properties
 
@@ -14,7 +14,7 @@ Defined in: [src/include-files.ts:6](https://github.com/isdk/util.js/blob/20d487
 
 > `optional` **exclude**: `string`[]
 
-Defined in: [src/include-files.ts:8](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/include-files.ts#L8)
+Defined in: [src/include-files.ts:8](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/include-files.ts#L8)
 
 ***
 
@@ -22,4 +22,4 @@ Defined in: [src/include-files.ts:8](https://github.com/isdk/util.js/blob/20d487
 
 > `optional` **include**: `string`[]
 
-Defined in: [src/include-files.ts:7](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/include-files.ts#L7)
+Defined in: [src/include-files.ts:7](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/include-files.ts#L7)

package/docs/interfaces/LoadConfigFileOptions.md

@@ -6,7 +6,7 @@
 
 # Interface: LoadConfigFileOptions
 
-Defined in: [src/config-file.ts:20](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/config-file.ts#L20)
+Defined in: [src/config-file.ts:20](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/config-file.ts#L20)
 
 ## Properties
 
@@ -14,7 +14,7 @@ Defined in: [src/config-file.ts:20](https://github.com/isdk/util.js/blob/20d4878
 
 > `optional` **externalFile**: `string`
 
-Defined in: [src/config-file.ts:22](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/config-file.ts#L22)
+Defined in: [src/config-file.ts:22](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/config-file.ts#L22)
 
 ***
 
@@ -22,4 +22,4 @@ Defined in: [src/config-file.ts:22](https://github.com/isdk/util.js/blob/20d4878
 
 > `optional` **extLevel**: `number`
 
-Defined in: [src/config-file.ts:21](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/config-file.ts#L21)
+Defined in: [src/config-file.ts:21](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/config-file.ts#L21)

package/docs/interfaces/SanitizeFilenameOptions.md

@@ -6,7 +6,7 @@
 
 # Interface: SanitizeFilenameOptions
 
-Defined in: [src/filename.ts:96](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/filename.ts#L96)
+Defined in: [src/filename.ts:96](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/filename.ts#L96)
 
 ## Properties
 
@@ -14,7 +14,7 @@ Defined in: [src/filename.ts:96](https://github.com/isdk/util.js/blob/20d48780d6
 
 > `optional` **maxLength**: `number`
 
-Defined in: [src/filename.ts:98](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/filename.ts#L98)
+Defined in: [src/filename.ts:98](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/filename.ts#L98)
 
 ***
 
@@ -22,4 +22,4 @@ Defined in: [src/filename.ts:98](https://github.com/isdk/util.js/blob/20d48780d6
 
 > `optional` **replacement**: `string`
 
-Defined in: [src/filename.ts:97](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/filename.ts#L97)
+Defined in: [src/filename.ts:97](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/filename.ts#L97)

package/docs/interfaces/SemaphoreOptions.md

@@ -6,7 +6,7 @@
 
 # Interface: SemaphoreOptions
 
-Defined in: [src/async-semaphore.ts:42](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L42)
+Defined in: [src/async-semaphore.ts:42](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L42)
 
 ## Extends
 
@@ -18,7 +18,7 @@ Defined in: [src/async-semaphore.ts:42](https://github.com/isdk/util.js/blob/20d
 
 > `optional` **capacity**: `number`
 
-Defined in: [src/async-semaphore.ts:25](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L25)
+Defined in: [src/async-semaphore.ts:25](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L25)
 
 #### Inherited from
 
@@ -30,7 +30,7 @@ Defined in: [src/async-semaphore.ts:25](https://github.com/isdk/util.js/blob/20d
 
 > `optional` **initFn**: () => `any`
 
-Defined in: [src/async-semaphore.ts:22](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L22)
+Defined in: [src/async-semaphore.ts:22](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L22)
 
 #### Returns
 
@@ -46,7 +46,7 @@ Defined in: [src/async-semaphore.ts:22](https://github.com/isdk/util.js/blob/20d
 
 > `optional` **isReadyFn**: [`SemaphoreIsReadyFuncType`](../type-aliases/SemaphoreIsReadyFuncType.md)
 
-Defined in: [src/async-semaphore.ts:44](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L44)
+Defined in: [src/async-semaphore.ts:44](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L44)
 
 ***
 
@@ -54,7 +54,7 @@ Defined in: [src/async-semaphore.ts:44](https://github.com/isdk/util.js/blob/20d
 
 > `optional` **maxConcurrency**: `number`
 
-Defined in: [src/async-semaphore.ts:43](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L43)
+Defined in: [src/async-semaphore.ts:43](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L43)
 
 ***
 
@@ -62,7 +62,7 @@ Defined in: [src/async-semaphore.ts:43](https://github.com/isdk/util.js/blob/20d
 
 > `optional` **pauseFn**: () => `void`
 
-Defined in: [src/async-semaphore.ts:23](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L23)
+Defined in: [src/async-semaphore.ts:23](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L23)
 
 #### Returns
 
@@ -78,7 +78,7 @@ Defined in: [src/async-semaphore.ts:23](https://github.com/isdk/util.js/blob/20d
 
 > `optional` **resumeFn**: () => `void`
 
-Defined in: [src/async-semaphore.ts:24](https://github.com/isdk/util.js/blob/20d48780d60e0a0a6f6a696a3efdfa46d4cb3b1e/src/async-semaphore.ts#L24)
+Defined in: [src/async-semaphore.ts:24](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L24)
 
 #### Returns