release: @black-flag/extensions@3.1.0 [skip ci]

## ✨ Features

- **packages/extensions:** ensure new and old `withUsageExtensions` call signatures are supported ([c5ada65][2])

[1]: https://github.com/Xunnamius/black-flag/compare/@black-flag/extensions@3.0.1...@black-flag/extensions@3.1.0
[2]: c5ada65

Author: Xunnamius

packages/extensions/CHANGELOG.md

@@ -6,86 +6,94 @@ this project adheres to [Semantic Versioning][2].
 
 <br />
 
-## @black-flag/extensions[@3.0.0][3] (2025-05-28)
+## @black-flag/extensions[@3.1.0][3] (2025-05-28)
+
+### ✨ Features
+
+- **packages/extensions:** ensure new and old `withUsageExtensions` call signatures are supported ([c5ada65][4])
+
+<br />
+
+## @black-flag/extensions[@3.0.0][5] (2025-05-28)
 
 ### 💥 BREAKING CHANGES 💥
 
 - Minimum supported node version is now 20.18.0
 
 ### ✨ Features
 
-- **packages/extensions:** add `includeSubCommand` option to `withUsageExtensions` ([0866421][4])
+- **packages/extensions:** add `includeSubCommand` option to `withUsageExtensions` ([0866421][6])
 
 ### ⚙️ Build System
 
-- Bump yargs from 17.7.2 to 18.0.0 and adjust usage accordingly ([379d98d][5])
-- **deps:** bump core-js from 3.41.0 to 3.42.0 ([ea1cae3][6])
-- **deps:** bump type-fest from 4.38.0 to 4.41.0 ([316c3f3][7])
-- **package:** drop support for node\@18 ([7a70c7e][8])
+- Bump yargs from 17.7.2 to 18.0.0 and adjust usage accordingly ([379d98d][7])
+- **deps:** bump core-js from 3.41.0 to 3.42.0 ([ea1cae3][8])
+- **deps:** bump type-fest from 4.38.0 to 4.41.0 ([316c3f3][9])
+- **package:** drop support for node\@18 ([7a70c7e][10])
 
 <br />
 
-### 🏗️ Patch @black-flag/extensions[@3.0.1][9] (2025-05-28)
+### 🏗️ Patch @black-flag/extensions[@3.0.1][11] (2025-05-28)
 
 #### 🪄 Fixes
 
-- **packages/extensions:** use breaking `withUsageExtensions` call signature ([65863de][10])
+- **packages/extensions:** use breaking `withUsageExtensions` call signature ([65863de][12])
 
 <br />
 
-## @black-flag/extensions[@2.2.0][11] (2025-03-19)
+## @black-flag/extensions[@2.2.0][13] (2025-03-19)
 
 ### ✨ Features
 
-- **packages/extensions:** allow tweaking `safeDeepClone` operations in `getInvocableExtendedHandler` ([f24e683][12])
+- **packages/extensions:** allow tweaking `safeDeepClone` operations in `getInvocableExtendedHandler` ([f24e683][14])
 
 ### 🪄 Fixes
 
-- **packages/extensions:** delete undefined defaults (as docs say should happen) instead of throwing framework error ([96ef5ef][13])
-- **packages/extensions:** improve `safeDeepClone` to account for own symbol properties ([119919e][14])
-- **packages/extensions:** replace internal `safeDeepClone` implementation with @-xun/js ([fff47db][15])
+- **packages/extensions:** delete undefined defaults (as docs say should happen) instead of throwing framework error ([96ef5ef][15])
+- **packages/extensions:** improve `safeDeepClone` to account for own symbol properties ([119919e][16])
+- **packages/extensions:** replace internal `safeDeepClone` implementation with @-xun/js ([fff47db][17])
 
 ### ⚙️ Build System
 
-- **deps:** bump @-xun/js from 1.0.0 to 1.1.0 ([c14d3cf][16])
-- **deps:** bump @-xun/js from 1.1.0 to 1.1.1 ([5f6dfff][17])
+- **deps:** bump @-xun/js from 1.0.0 to 1.1.0 ([c14d3cf][18])
+- **deps:** bump @-xun/js from 1.1.0 to 1.1.1 ([5f6dfff][19])
 
 <br />
 
-### 🏗️ Patch @black-flag/extensions[@2.2.2][18] (2025-03-25)
+### 🏗️ Patch @black-flag/extensions[@2.2.2][20] (2025-03-25)
 
 #### ⚙️ Build System
 
-- **deps:** bump type-fest from 4.37.0 to 4.38.0 ([73e99db][19])
+- **deps:** bump type-fest from 4.37.0 to 4.38.0 ([73e99db][21])
 
 <br />
 
-### 🏗️ Patch @black-flag/extensions[@2.2.1][20] (2025-03-20)
+### 🏗️ Patch @black-flag/extensions[@2.2.1][22] (2025-03-20)
 
 #### 🪄 Fixes
 
-- **packages/extensions:** replace option defaults with resolved implications when outputting help text ([f95c583][21])
+- **packages/extensions:** replace option defaults with resolved implications when outputting help text ([f95c583][23])
 
 <br />
 
-## @black-flag/extensions[@2.1.0][22] (2025-03-17)
+## @black-flag/extensions[@2.1.0][24] (2025-03-17)
 
 ### ✨ Features
 
-- **packages/extensions:** implement `enableAutomaticSorting` option for `withBuilderExtensions` ([3b93860][23]) <sup>see [#182][24]</sup>
+- **packages/extensions:** implement `enableAutomaticSorting` option for `withBuilderExtensions` ([3b93860][25]) <sup>see [#182][26]</sup>
 
 ### 🪄 Fixes
 
-- **packages/extensions:** fix `getInvocableExtendedHandler` contextual "cross-talk" issue ([1adf708][25]) <sup>see [#175][26]</sup>
+- **packages/extensions:** fix `getInvocableExtendedHandler` contextual "cross-talk" issue ([1adf708][27]) <sup>see [#175][28]</sup>
 
 ### ⚙️ Build System
 
-- **deps:** bump core-js from 3.40.0 to 3.41.0 ([12658b9][27])
-- **deps:** bump core-js from 3.40.0 to 3.41.0 ([9371719][28])
+- **deps:** bump core-js from 3.40.0 to 3.41.0 ([12658b9][29])
+- **deps:** bump core-js from 3.40.0 to 3.41.0 ([9371719][30])
 
 <br />
 
-## @black-flag/extensions[@2.0.0][29] (2025-03-14)
+## @black-flag/extensions[@2.0.0][31] (2025-03-14)
 
 ### 💥 BREAKING CHANGES 💥
 
@@ -97,76 +105,78 @@ this project adheres to [Semantic Versioning][2].
 
 ### ✨ Features
 
-- **packages/extensions:** implement @black-flag/extensions ([f0525c5][30])
+- **packages/extensions:** implement @black-flag/extensions ([f0525c5][32])
 
 ### 🪄 Fixes
 
-- Fix Windows interop issues ([b3abf95][31]) <sup>see [#174][32]</sup>
+- Fix Windows interop issues ([b3abf95][33]) <sup>see [#174][34]</sup>
 
 ### ⚙️ Build System
 
-- **deps:** bump type-fest from 4.35.0 to 4.36.0 ([80350cc][33])
-- **deps:** bump type-fest from 4.36.0 to 4.37.0 ([7c8ff7a][34])
-- **husky:** force lint-staged (via husky) to only use global config file ([5d3f2cc][35])
-- **packages/extensions:** use correct git repo metadata in package.json ([0548f8f][36])
+- **deps:** bump type-fest from 4.35.0 to 4.36.0 ([80350cc][35])
+- **deps:** bump type-fest from 4.36.0 to 4.37.0 ([7c8ff7a][36])
+- **husky:** force lint-staged (via husky) to only use global config file ([5d3f2cc][37])
+- **packages/extensions:** use correct git repo metadata in package.json ([0548f8f][38])
 
 ### 🧙🏿 Refactored
 
-- Make exported symbols cross-realm ([af78a8f][37])
-- Rename and restructure exports for better docs generation ([8303ba7][38])
+- Make exported symbols cross-realm ([af78a8f][39])
+- Rename and restructure exports for better docs generation ([8303ba7][40])
 
 ### 🔥 Reverted
 
-- _"build(deps): bump core-js from 3.40.0 to 3.41.0"_ ([aebeab7][39])
+- _"build(deps): bump core-js from 3.40.0 to 3.41.0"_ ([aebeab7][41])
 
-## @black-flag/extensions[@1.0.2][40] (2025-02-21)
+## @black-flag/extensions[@1.0.2][42] (2025-02-21)
 
 #### ⚙️ Build System
 
-- **husky:** update to latest hooks ([75d5c66][41])
-- **tsconfig:** fix internal path resolution ([fbe3a69][42])
-- **tsconfig:** upgrade to NodeNext ([d3a499e][43])
+- **husky:** update to latest hooks ([75d5c66][43])
+- **tsconfig:** fix internal path resolution ([fbe3a69][44])
+- **tsconfig:** upgrade to NodeNext ([d3a499e][45])
 
 [1]: https://conventionalcommits.org
 [2]: https://semver.org
-[3]: https://github.com/Xunnamius/black-flag/compare/@black-flag/extensions@2.2.2...@black-flag/extensions@3.0.0
-[4]: https://github.com/Xunnamius/black-flag/commit/0866421689eb12206a72880c2087d3fcf02f097e
-[5]: https://github.com/Xunnamius/black-flag/commit/379d98d3658e906242f405ab4234d58967b5d218
-[6]: https://github.com/Xunnamius/black-flag/commit/ea1cae3c0090577caeddd1155855334a6a3398ba
-[7]: https://github.com/Xunnamius/black-flag/commit/316c3f3f2a74bee2d8d5836119a527a8605a58a5
-[8]: https://github.com/Xunnamius/black-flag/commit/7a70c7e44633bf3b15b0662ce212ece66de038c8
-[9]: https://github.com/Xunnamius/black-flag/compare/@black-flag/extensions@3.0.0...@black-flag/extensions@3.0.1
-[10]: https://github.com/Xunnamius/black-flag/commit/65863debdad33d702508c3459cced432c1437abf
-[11]: https://github.com/Xunnamius/black-flag/compare/@black-flag/extensions@2.1.0...@black-flag/extensions@2.2.0
-[12]: https://github.com/Xunnamius/black-flag/commit/f24e683503f57d7c6785584366260d2a19cae1f1
-[13]: https://github.com/Xunnamius/black-flag/commit/96ef5ef271071d7886664e00b661d5f21655c0f3
-[14]: https://github.com/Xunnamius/black-flag/commit/119919ef40e6a89644ec3156b9bae57c5e24b459
-[15]: https://github.com/Xunnamius/black-flag/commit/fff47db4d3a0610fec0fdd48ba7a5cf006993ac7
-[16]: https://github.com/Xunnamius/black-flag/commit/c14d3cf8c1964184f8d222e6586eb6c95c5b4fbb
-[17]: https://github.com/Xunnamius/black-flag/commit/5f6dfffed3686aa83522ed99127c8acc6eff7158
-[18]: https://github.com/Xunnamius/black-flag/compare/@black-flag/extensions@2.2.1...@black-flag/extensions@2.2.2
-[19]: https://github.com/Xunnamius/black-flag/commit/73e99dbbbcc8a2954ffc14a653e893e01b7d050e
-[20]: https://github.com/Xunnamius/black-flag/compare/@black-flag/extensions@2.2.0...@black-flag/extensions@2.2.1
-[21]: https://github.com/Xunnamius/black-flag/commit/f95c583e511ffd5017418cd59d849f0c324c1189
-[22]: https://github.com/Xunnamius/black-flag/compare/@black-flag/extensions@2.0.0...@black-flag/extensions@2.1.0
-[23]: https://github.com/Xunnamius/black-flag/commit/3b9386082ffb4c7b2987c0f2b2e00e6cd48ad4bb
-[24]: https://github.com/Xunnamius/black-flag/issues/182
-[25]: https://github.com/Xunnamius/black-flag/commit/1adf7086f5837a4166d7bdfc87028a031d772480
-[26]: https://github.com/Xunnamius/black-flag/issues/175
-[27]: https://github.com/Xunnamius/black-flag/commit/12658b92d7bda44a0105775dae2db2cb0a1fcdee
-[28]: https://github.com/Xunnamius/black-flag/commit/937171967cd8887a8aba12cbb23c0adffacc6c78
-[29]: https://github.com/Xunnamius/black-flag/compare/@black-flag/extensions@1.0.2...@black-flag/extensions@2.0.0
-[30]: https://github.com/Xunnamius/black-flag/commit/f0525c5f4bf72b0f28fedf4f6d66f4a1b7353b05
-[31]: https://github.com/Xunnamius/black-flag/commit/b3abf95ca2958d5d2fca1091178c050ef88fe5f5
-[32]: https://github.com/Xunnamius/black-flag/issues/174
-[33]: https://github.com/Xunnamius/black-flag/commit/80350cca61bef915d737fb097e4e3838118a1167
-[34]: https://github.com/Xunnamius/black-flag/commit/7c8ff7ad8ffd4d822329278da0a21db54f904f25
-[35]: https://github.com/Xunnamius/black-flag/commit/5d3f2ccdfcd615917892d27a5c2cfa1b28879e0c
-[36]: https://github.com/Xunnamius/black-flag/commit/0548f8fe3c7daa363173184e34f2307f8964dbed
-[37]: https://github.com/Xunnamius/black-flag/commit/af78a8fbc5839e0d3db1b07312bbc854ef1b7a0d
-[38]: https://github.com/Xunnamius/black-flag/commit/8303ba7f438ae7f7dedfc2b6f5fd396cab32b252
-[39]: https://github.com/Xunnamius/black-flag/commit/aebeab7d2567bc70eedd5920ea51c02bfe3dc081
-[40]: https://github.com/Xunnamius/black-flag/compare/d3a499e7aeddf23d392479b2cf99cc98bce8226f...@black-flag/extensions@1.0.2
-[41]: https://github.com/Xunnamius/black-flag/commit/75d5c66bcce8f0c2c139962f7ddd28aa0c9499d7
-[42]: https://github.com/Xunnamius/black-flag/commit/fbe3a699a9063ed7da08311a22fe798672583b0f
-[43]: https://github.com/Xunnamius/black-flag/commit/d3a499e7aeddf23d392479b2cf99cc98bce8226f
+[3]: https://github.com/Xunnamius/black-flag/compare/@black-flag/extensions@3.0.1...@black-flag/extensions@3.1.0
+[4]: https://github.com/Xunnamius/black-flag/commit/c5ada654b2eb8206c373e88bdba1d3a12ccec944
+[5]: https://github.com/Xunnamius/black-flag/compare/@black-flag/extensions@2.2.2...@black-flag/extensions@3.0.0
+[6]: https://github.com/Xunnamius/black-flag/commit/0866421689eb12206a72880c2087d3fcf02f097e
+[7]: https://github.com/Xunnamius/black-flag/commit/379d98d3658e906242f405ab4234d58967b5d218
+[8]: https://github.com/Xunnamius/black-flag/commit/ea1cae3c0090577caeddd1155855334a6a3398ba
+[9]: https://github.com/Xunnamius/black-flag/commit/316c3f3f2a74bee2d8d5836119a527a8605a58a5
+[10]: https://github.com/Xunnamius/black-flag/commit/7a70c7e44633bf3b15b0662ce212ece66de038c8
+[11]: https://github.com/Xunnamius/black-flag/compare/@black-flag/extensions@3.0.0...@black-flag/extensions@3.0.1
+[12]: https://github.com/Xunnamius/black-flag/commit/65863debdad33d702508c3459cced432c1437abf
+[13]: https://github.com/Xunnamius/black-flag/compare/@black-flag/extensions@2.1.0...@black-flag/extensions@2.2.0
+[14]: https://github.com/Xunnamius/black-flag/commit/f24e683503f57d7c6785584366260d2a19cae1f1
+[15]: https://github.com/Xunnamius/black-flag/commit/96ef5ef271071d7886664e00b661d5f21655c0f3
+[16]: https://github.com/Xunnamius/black-flag/commit/119919ef40e6a89644ec3156b9bae57c5e24b459
+[17]: https://github.com/Xunnamius/black-flag/commit/fff47db4d3a0610fec0fdd48ba7a5cf006993ac7
+[18]: https://github.com/Xunnamius/black-flag/commit/c14d3cf8c1964184f8d222e6586eb6c95c5b4fbb
+[19]: https://github.com/Xunnamius/black-flag/commit/5f6dfffed3686aa83522ed99127c8acc6eff7158
+[20]: https://github.com/Xunnamius/black-flag/compare/@black-flag/extensions@2.2.1...@black-flag/extensions@2.2.2
+[21]: https://github.com/Xunnamius/black-flag/commit/73e99dbbbcc8a2954ffc14a653e893e01b7d050e
+[22]: https://github.com/Xunnamius/black-flag/compare/@black-flag/extensions@2.2.0...@black-flag/extensions@2.2.1
+[23]: https://github.com/Xunnamius/black-flag/commit/f95c583e511ffd5017418cd59d849f0c324c1189
+[24]: https://github.com/Xunnamius/black-flag/compare/@black-flag/extensions@2.0.0...@black-flag/extensions@2.1.0
+[25]: https://github.com/Xunnamius/black-flag/commit/3b9386082ffb4c7b2987c0f2b2e00e6cd48ad4bb
+[26]: https://github.com/Xunnamius/black-flag/issues/182
+[27]: https://github.com/Xunnamius/black-flag/commit/1adf7086f5837a4166d7bdfc87028a031d772480
+[28]: https://github.com/Xunnamius/black-flag/issues/175
+[29]: https://github.com/Xunnamius/black-flag/commit/12658b92d7bda44a0105775dae2db2cb0a1fcdee
+[30]: https://github.com/Xunnamius/black-flag/commit/937171967cd8887a8aba12cbb23c0adffacc6c78
+[31]: https://github.com/Xunnamius/black-flag/compare/@black-flag/extensions@1.0.2...@black-flag/extensions@2.0.0
+[32]: https://github.com/Xunnamius/black-flag/commit/f0525c5f4bf72b0f28fedf4f6d66f4a1b7353b05
+[33]: https://github.com/Xunnamius/black-flag/commit/b3abf95ca2958d5d2fca1091178c050ef88fe5f5
+[34]: https://github.com/Xunnamius/black-flag/issues/174
+[35]: https://github.com/Xunnamius/black-flag/commit/80350cca61bef915d737fb097e4e3838118a1167
+[36]: https://github.com/Xunnamius/black-flag/commit/7c8ff7ad8ffd4d822329278da0a21db54f904f25
+[37]: https://github.com/Xunnamius/black-flag/commit/5d3f2ccdfcd615917892d27a5c2cfa1b28879e0c
+[38]: https://github.com/Xunnamius/black-flag/commit/0548f8fe3c7daa363173184e34f2307f8964dbed
+[39]: https://github.com/Xunnamius/black-flag/commit/af78a8fbc5839e0d3db1b07312bbc854ef1b7a0d
+[40]: https://github.com/Xunnamius/black-flag/commit/8303ba7f438ae7f7dedfc2b6f5fd396cab32b252
+[41]: https://github.com/Xunnamius/black-flag/commit/aebeab7d2567bc70eedd5920ea51c02bfe3dc081
+[42]: https://github.com/Xunnamius/black-flag/compare/d3a499e7aeddf23d392479b2cf99cc98bce8226f...@black-flag/extensions@1.0.2
+[43]: https://github.com/Xunnamius/black-flag/commit/75d5c66bcce8f0c2c139962f7ddd28aa0c9499d7
+[44]: https://github.com/Xunnamius/black-flag/commit/fbe3a699a9063ed7da08311a22fe798672583b0f
+[45]: https://github.com/Xunnamius/black-flag/commit/d3a499e7aeddf23d392479b2cf99cc98bce8226f

packages/extensions/docs/constant/variables/globalDebuggerNamespace.md

@@ -8,6 +8,6 @@
 
 > `const` **globalDebuggerNamespace**: `"bfe"` = `'bfe'`
 
-Defined in: [packages/extensions/src/constant.ts:4](https://github.com/Xunnamius/black-flag/blob/65863debdad33d702508c3459cced432c1437abf/packages/extensions/src/constant.ts#L4)
+Defined in: [packages/extensions/src/constant.ts:4](https://github.com/Xunnamius/black-flag/blob/c5ada654b2eb8206c373e88bdba1d3a12ccec944/packages/extensions/src/constant.ts#L4)
 
 The project-wide namespace that appears in debugger output.

packages/extensions/docs/error/type-aliases/KeyValueEntries.md

@@ -8,4 +8,4 @@
 
 > **KeyValueEntries** = `Entries`\<\{[`x`: `string`]: `unknown`; \}\>
 
-Defined in: [packages/extensions/src/error.ts:7](https://github.com/Xunnamius/black-flag/blob/65863debdad33d702508c3459cced432c1437abf/packages/extensions/src/error.ts#L7)
+Defined in: [packages/extensions/src/error.ts:7](https://github.com/Xunnamius/black-flag/blob/c5ada654b2eb8206c373e88bdba1d3a12ccec944/packages/extensions/src/error.ts#L7)

packages/extensions/docs/error/type-aliases/KeyValueEntry.md

@@ -8,4 +8,4 @@
 
 > **KeyValueEntry** = [`KeyValueEntries`](KeyValueEntries.md)\[`number`\]
 
-Defined in: [packages/extensions/src/error.ts:8](https://github.com/Xunnamius/black-flag/blob/65863debdad33d702508c3459cced432c1437abf/packages/extensions/src/error.ts#L8)
+Defined in: [packages/extensions/src/error.ts:8](https://github.com/Xunnamius/black-flag/blob/c5ada654b2eb8206c373e88bdba1d3a12ccec944/packages/extensions/src/error.ts#L8)

packages/extensions/docs/error/variables/BfeErrorMessage.md

@@ -8,7 +8,7 @@
 
 > `const` **BfeErrorMessage**: `object`
 
-Defined in: [packages/extensions/src/error.ts:14](https://github.com/Xunnamius/black-flag/blob/65863debdad33d702508c3459cced432c1437abf/packages/extensions/src/error.ts#L14)
+Defined in: [packages/extensions/src/error.ts:14](https://github.com/Xunnamius/black-flag/blob/c5ada654b2eb8206c373e88bdba1d3a12ccec944/packages/extensions/src/error.ts#L14)
 
 A collection of possible error and warning messages.
 

packages/extensions/docs/index/README.md

@@ -28,6 +28,7 @@
 - [WithBuilderExtensionsConfig](type-aliases/WithBuilderExtensionsConfig.md)
 - [WithBuilderExtensionsReturnType](type-aliases/WithBuilderExtensionsReturnType.md)
 - [WithHandlerExtensions](type-aliases/WithHandlerExtensions.md)
+- [WithUsageExtensionsConfig](type-aliases/WithUsageExtensionsConfig.md)
 
 ## Functions
 

packages/extensions/docs/index/functions/getInvocableExtendedHandler.md

@@ -8,7 +8,7 @@
 
 > **getInvocableExtendedHandler**\<`CustomCliArguments`, `CustomExecutionContext`\>(`maybeCommand`, `context`): `Promise`\<(`argv`) => `Promise`\<`void`\>\>
 
-Defined in: [packages/extensions/src/index.ts:1472](https://github.com/Xunnamius/black-flag/blob/65863debdad33d702508c3459cced432c1437abf/packages/extensions/src/index.ts#L1472)
+Defined in: [packages/extensions/src/index.ts:1495](https://github.com/Xunnamius/black-flag/blob/c5ada654b2eb8206c373e88bdba1d3a12ccec944/packages/extensions/src/index.ts#L1495)
 
 This function returns a version of `maybeCommand`'s handler function that is
 ready to invoke immediately. It can be used with both BFE and normal Black

packages/extensions/docs/index/functions/withBuilderExtensions.md

@@ -8,7 +8,7 @@
 
 > **withBuilderExtensions**\<`CustomCliArguments`, `CustomExecutionContext`\>(`customBuilder?`, `__namedParameters?`): [`WithBuilderExtensionsReturnType`](../type-aliases/WithBuilderExtensionsReturnType.md)\<`CustomCliArguments`, `CustomExecutionContext`\>
 
-Defined in: [packages/extensions/src/index.ts:749](https://github.com/Xunnamius/black-flag/blob/65863debdad33d702508c3459cced432c1437abf/packages/extensions/src/index.ts#L749)
+Defined in: [packages/extensions/src/index.ts:797](https://github.com/Xunnamius/black-flag/blob/c5ada654b2eb8206c373e88bdba1d3a12ccec944/packages/extensions/src/index.ts#L797)
 
 This function enables several additional options-related units of
 functionality via analysis of the returned options configuration object and