@isdk/util 0.3.9 → 0.3.10

package/docs/interfaces/ExtractCodeBlockOptions.md

@@ -6,7 +6,7 @@
 
 # Interface: ExtractCodeBlockOptions
 
-Defined in: [src/extract-code-block.ts:53](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/extract-code-block.ts#L53)
+Defined in: [src/extract-code-block.ts:53](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/extract-code-block.ts#L53)
 
 Options for extracting code blocks.
 
@@ -14,9 +14,9 @@ Options for extracting code blocks.
 
 ### all?
 
-> `optional` **all**: `boolean`
+> `optional` **all?**: `boolean`
 
-Defined in: [src/extract-code-block.ts:71](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/extract-code-block.ts#L71)
+Defined in: [src/extract-code-block.ts:71](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/extract-code-block.ts#L71)
 
 Optional. If true, returns an array of all matching code blocks.
 
@@ -24,9 +24,9 @@ Optional. If true, returns an array of all matching code blocks.
 
 ### index?
 
-> `optional` **index**: `number`
+> `optional` **index?**: `number`
 
-Defined in: [src/extract-code-block.ts:67](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/extract-code-block.ts#L67)
+Defined in: [src/extract-code-block.ts:67](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/extract-code-block.ts#L67)
 
 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.
@@ -36,9 +36,9 @@ Defaults to -1.
 
 ### lang?
 
-> `optional` **lang**: `string`
+> `optional` **lang?**: `string` \| `string`[]
 
-Defined in: [src/extract-code-block.ts:61](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/extract-code-block.ts#L61)
+Defined in: [src/extract-code-block.ts:61](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/extract-code-block.ts#L61)
 
 Optional. The expected language identifier or a CSS-like selector path.
 Supports aliases (e.g., 'js' for 'javascript').
@@ -57,8 +57,8 @@ Supports aliases (e.g., 'js' for 'javascript').
 
 ### langMap?
 
-> `optional` **langMap**: `Record`\<`string`, `string`\>
+> `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)
+Defined in: [src/extract-code-block.ts:75](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/extract-code-block.ts#L75)
 
 Optional. A map of language aliases to their normalized names.

package/docs/interfaces/FindPortOptions.md

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

package/docs/interfaces/IncludeFiles.md

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

package/docs/interfaces/LoadConfigFileOptions.md

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

package/docs/interfaces/SanitizeFilenameOptions.md

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

package/docs/interfaces/SemaphoreOptions.md

@@ -6,7 +6,9 @@
 
 # Interface: SemaphoreOptions
 
-Defined in: [src/async-semaphore.ts:42](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L42)
+Defined in: [src/async-semaphore.ts:110](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/async-semaphore.ts#L110)
+
+通用信号量的配置选项，继承自二进制信号量选项。
 
 ## Extends
 
@@ -16,9 +18,12 @@ Defined in: [src/async-semaphore.ts:42](https://github.com/isdk/util.js/blob/30c
 
 ### capacity?
 
-> `optional` **capacity**: `number`
+> `optional` **capacity?**: `number`
+
+Defined in: [src/async-semaphore.ts:64](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/async-semaphore.ts#L64)
 
-Defined in: [src/async-semaphore.ts:25](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L25)
+内部等待队列的初始预分配容量。
+适用于高性能场景，开发者可以根据并发规模预估此值以减少动态扩容。
 
 #### Inherited from
 
@@ -26,11 +31,15 @@ Defined in: [src/async-semaphore.ts:25](https://github.com/isdk/util.js/blob/30c
 
 ***
 
-### initFn()?
+### initFn?
 
-> `optional` **initFn**: () => `any`
+> `optional` **initFn?**: () => `any`
 
-Defined in: [src/async-semaphore.ts:22](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L22)
+Defined in: [src/async-semaphore.ts:47](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/async-semaphore.ts#L47)
+
+用于初始化令牌的函数。
+当信号量释放且没有等待任务时，如果未提供令牌，将调用此函数生成新令牌。
+默认为 `() => '1'`。
 
 #### Returns
 
@@ -44,25 +53,35 @@ Defined in: [src/async-semaphore.ts:22](https://github.com/isdk/util.js/blob/30c
 
 ### isReadyFn?
 
-> `optional` **isReadyFn**: [`SemaphoreIsReadyFuncType`](../type-aliases/SemaphoreIsReadyFuncType.md)
+> `optional` **isReadyFn?**: [`SemaphoreIsReadyFuncType`](../type-aliases/SemaphoreIsReadyFuncType.md)
+
+Defined in: [src/async-semaphore.ts:120](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/async-semaphore.ts#L120)
 
-Defined in: [src/async-semaphore.ts:44](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L44)
+可选的就绪检查函数。
+在尝试获取令牌前调用，如果返回 false（或解析为 false 的 Promise），则无法立即获取。
 
 ***
 
 ### maxConcurrency?
 
-> `optional` **maxConcurrency**: `number`
+> `optional` **maxConcurrency?**: `number`
 
-Defined in: [src/async-semaphore.ts:43](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L43)
+Defined in: [src/async-semaphore.ts:115](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/async-semaphore.ts#L115)
+
+最大并发数。
+指定允许同时获取信号量的最大调用方数量。
 
 ***
 
-### pauseFn()?
+### pauseFn?
+
+> `optional` **pauseFn?**: () => `void`
 
-> `optional` **pauseFn**: () => `void`
+Defined in: [src/async-semaphore.ts:53](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/async-semaphore.ts#L53)
 
-Defined in: [src/async-semaphore.ts:23](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L23)
+可选的暂停函数。
+当等待队列开始积压（第一个任务进入队列）时调用，用于通知上游停止发送数据，
+以避免产生过多的等待 Promise 导致内存溢出。
 
 #### Returns
 
@@ -74,11 +93,15 @@ Defined in: [src/async-semaphore.ts:23](https://github.com/isdk/util.js/blob/30c
 
 ***
 
-### resumeFn()?
+### resumeFn?
+
+> `optional` **resumeFn?**: () => `void`
 
-> `optional` **resumeFn**: () => `void`
+Defined in: [src/async-semaphore.ts:59](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/async-semaphore.ts#L59)
 
-Defined in: [src/async-semaphore.ts:24](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L24)
+可选的恢复函数。
+当信号量有空闲槽位且之前已调用过 `pauseFn` 时调用。
+如果定义了 `pauseFn`，则必须同时定义此函数。
 
 #### Returns
 

package/docs/interfaces/SemaphoreTaskItem.md

@@ -6,7 +6,9 @@
 
 # Interface: SemaphoreTaskItem
 
-Defined in: [src/async-semaphore.ts:52](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L52)
+Defined in: [src/async-semaphore.ts:126](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/async-semaphore.ts#L126)
+
+内部等待任务项的结构定义。
 
 ## Extends
 
@@ -14,15 +16,19 @@ Defined in: [src/async-semaphore.ts:52](https://github.com/isdk/util.js/blob/30c
 
 ## Indexable
 
-\[`n`: `string`\]: `any`
+> \[`n`: `string`\]: `any`
+
+允许扩展其他自定义选项。
 
 ## Properties
 
-### reject()
+### reject
 
 > **reject**: (`reason?`) => `void`
 
-Defined in: [src/async-semaphore.ts:54](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L54)
+Defined in: [src/async-semaphore.ts:134](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/async-semaphore.ts#L134)
+
+当获取失败（如被中止）时调用的拒绝函数。
 
 #### Parameters
 
@@ -36,11 +42,13 @@ Defined in: [src/async-semaphore.ts:54](https://github.com/isdk/util.js/blob/30c
 
 ***
 
-### resolve()
+### resolve
 
 > **resolve**: (`value`) => `void`
 
-Defined in: [src/async-semaphore.ts:53](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L53)
+Defined in: [src/async-semaphore.ts:130](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/async-semaphore.ts#L130)
+
+当获取成功时调用的解析函数，接收释放函数作为参数。
 
 #### Parameters
 
@@ -56,9 +64,12 @@ Defined in: [src/async-semaphore.ts:53](https://github.com/isdk/util.js/blob/30c
 
 ### signal?
 
-> `optional` **signal**: `AbortSignal`
+> `optional` **signal?**: `AbortSignal`
+
+Defined in: [src/async-semaphore.ts:75](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/async-semaphore.ts#L75)
 
-Defined in: [src/async-semaphore.ts:29](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L29)
+可选的 AbortSignal，用于取消获取操作。
+如果在获取到令牌前信号被中止，`acquire` 返回的 Promise 将被拒绝并抛出 `AbortError`。
 
 #### Inherited from
 
@@ -68,6 +79,8 @@ Defined in: [src/async-semaphore.ts:29](https://github.com/isdk/util.js/blob/30c
 
 ### token?
 
-> `optional` **token**: `any`
+> `optional` **token?**: `any`
+
+Defined in: [src/async-semaphore.ts:138](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/async-semaphore.ts#L138)
 
-Defined in: [src/async-semaphore.ts:55](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L55)
+与此任务关联的令牌。

package/docs/type-aliases/CodeBlockCombinator.md

@@ -8,7 +8,7 @@
 
 > **CodeBlockCombinator** = `">"` \| `" "` \| `"+"` \| `"~"`
 
-Defined in: [src/extract-code-block.ts:29](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/extract-code-block.ts#L29)
+Defined in: [src/extract-code-block.ts:29](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/extract-code-block.ts#L29)
 
 Supported combinators for code block selectors.
 

package/docs/type-aliases/SemaphoreIsReadyFuncType.md

@@ -4,11 +4,14 @@
 
 [@isdk/util](../globals.md) / SemaphoreIsReadyFuncType
 
-# Type Alias: SemaphoreIsReadyFuncType()
+# Type Alias: SemaphoreIsReadyFuncType
 
 > **SemaphoreIsReadyFuncType** = () => `Promise`\<`boolean`\> \| `boolean`
 
-Defined in: [src/async-semaphore.ts:11](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L11)
+Defined in: [src/async-semaphore.ts:19](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/async-semaphore.ts#L19)
+
+就绪检查函数的类型定义。
+可以是同步或异步函数。返回 `true` 表示信号量已准备好接受新请求。
 
 ## Returns
 

package/docs/type-aliases/StringifyFunc.md

@@ -4,11 +4,11 @@
 
 [@isdk/util](../globals.md) / StringifyFunc
 
-# Type Alias: StringifyFunc()
+# Type Alias: StringifyFunc
 
 > **StringifyFunc** = (`content`) => `string`
 
-Defined in: [src/config-file.ts:18](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/config-file.ts#L18)
+Defined in: [src/config-file.ts:18](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/config-file.ts#L18)
 
 ## Parameters
 

package/docs/type-aliases/TraverseFolderHandler.md

@@ -4,11 +4,11 @@
 
 [@isdk/util](../globals.md) / TraverseFolderHandler
 
-# Type Alias: TraverseFolderHandler()
+# Type Alias: TraverseFolderHandler
 
 > **TraverseFolderHandler** = (`filePath`, `entry`) => `boolean` \| `void` \| `Promise`\<`boolean` \| `void`\>
 
-Defined in: [src/traverse-folder.ts:11](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/traverse-folder.ts#L11)
+Defined in: [src/traverse-folder.ts:11](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/traverse-folder.ts#L11)
 
 A handler function for asynchronous folder traversal.
 

package/docs/type-aliases/TraverseFolderSyncHandler.md

@@ -4,11 +4,11 @@
 
 [@isdk/util](../globals.md) / TraverseFolderSyncHandler
 
-# Type Alias: TraverseFolderSyncHandler()
+# Type Alias: TraverseFolderSyncHandler
 
 > **TraverseFolderSyncHandler** = (`filePath`, `entry`) => `boolean` \| `void`
 
-Defined in: [src/traverse-folder.ts:21](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/traverse-folder.ts#L21)
+Defined in: [src/traverse-folder.ts:21](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/traverse-folder.ts#L21)
 
 A handler function for synchronous folder traversal.
 

package/docs/variables/DefaultAllTextFiles.md

@@ -8,4 +8,4 @@
 
 > `const` **DefaultAllTextFiles**: `string`[]
 
-Defined in: [src/include-files.ts:1](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/include-files.ts#L1)
+Defined in: [src/include-files.ts:1](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/include-files.ts#L1)

package/docs/variables/DefaultAsyncSemaphoreCapacity.md

@@ -8,4 +8,7 @@
 
 > `const` **DefaultAsyncSemaphoreCapacity**: `32` = `32`
 
-Defined in: [src/async-semaphore.ts:9](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/async-semaphore.ts#L9)
+Defined in: [src/async-semaphore.ts:13](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/async-semaphore.ts#L13)
+
+信号量内部等待队列的默认预分配容量。
+当选项中未指定容量时使用此值。

package/docs/variables/FilenameReservedRegex.md

@@ -8,7 +8,7 @@
 
 > `const` **FilenameReservedRegex**: `RegExp`
 
-Defined in: [src/filename.ts:9](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/filename.ts#L9)
+Defined in: [src/filename.ts:9](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/filename.ts#L9)
 
 Regular expression pattern for reserved characters in a filename.
 do not use /g global option here: when the regex is executed multiple times, it will always begin where it left off last time.

package/docs/variables/WindowsReservedNameRegex.md

@@ -8,6 +8,6 @@
 
 > `const` **WindowsReservedNameRegex**: `RegExp`
 
-Defined in: [src/filename.ts:14](https://github.com/isdk/util.js/blob/30c54a8a455a9593000448de2a45f94a197d73de/src/filename.ts#L14)
+Defined in: [src/filename.ts:14](https://github.com/isdk/util.js/blob/c98bd1bf94d1b1dc8d01c6b9a6fc50b4beec5c62/src/filename.ts#L14)
 
 Regular expression pattern for reserved names on Windows systems.

package/package.json

@@ -1,38 +1,38 @@
 {
   "name": "@isdk/util",
   "description": "a set of utility functions",
-  "version": "0.3.9",
+  "version": "0.3.10",
   "author": "Riceball LEE @snowyu",
   "bugs": "https://github.com/isdk/util.js/issues",
   "dependencies": {
-    "@isdk/common-error": "^0.2.0",
+    "@isdk/common-error": "^0.2.2",
     "@isdk/glob": "^0.1.1",
-    "events-ex": "^2.1.1",
+    "events-ex": "^2.3.1",
     "load-config-file": "^2.1.0",
-    "lodash-es": "^4.17.23",
-    "util-ex": "^2.5.1",
-    "yaml": "^2.8.2"
+    "lodash-es": "^4.18.1",
+    "util-ex": "^2.6.0",
+    "yaml": "^2.9.0"
   },
   "devDependencies": {
-    "@eslint/eslintrc": "^3.3.3",
+    "@eslint/eslintrc": "^3.3.5",
     "@eslint/js": "^10.0.1",
     "@types/chai": "^5",
     "@types/jest": "^30.0.0",
     "@types/lodash-es": "^4.17.12",
-    "@types/node": "^25",
+    "@types/node": "^26",
     "eslint": "^10",
     "eslint-config-prettier": "^10",
-    "prettier": "^3.8.1",
+    "prettier": "^3.8.4",
     "shx": "^0.4.0",
-    "terser": "^5.46.0",
+    "terser": "^5.48.0",
     "tsup": "^8.5.1",
-    "tsx": "^4.21.0",
-    "typedoc": "^0.28.16",
-    "typedoc-plugin-markdown": "^4.10.0",
+    "tsx": "^4.22.4",
+    "typedoc": "^0.28.19",
+    "typedoc-plugin-markdown": "^4.12.0",
     "typescript": "^5.7.3",
-    "typescript-eslint": "^8.55.0",
-    "vite": "^7.3.1",
-    "vitest": "^4.0.18"
+    "typescript-eslint": "^8.62.0",
+    "vite": "^8.1.0",
+    "vitest": "^4.1.9"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -53,7 +53,10 @@
       "import": "./dist/index.mjs"
     }
   },
-  "repository": "isdk/util.js",
+  "repository": {
+    "type": "git",
+    "url": "isdk/util.js"
+  },
   "types": "dist/index.d.ts",
   "scripts": {
     "build-fast": "tsup",