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

## 🪄 Fixes

- **packages/extensions:** use breaking `withUsageExtensions` call signature ([65863de][2])

[1]: https://github.com/Xunnamius/black-flag/compare/@black-flag/extensions@3.0.0...@black-flag/extensions@3.0.1
[2]: 65863de

Author: Xunnamius

packages/extensions/CHANGELOG.md

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

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/3764563cebc186c7e5f9e6fd9ad3d54a1192fe57/packages/extensions/src/constant.ts#L4)
+Defined in: [packages/extensions/src/constant.ts:4](https://github.com/Xunnamius/black-flag/blob/65863debdad33d702508c3459cced432c1437abf/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/3764563cebc186c7e5f9e6fd9ad3d54a1192fe57/packages/extensions/src/error.ts#L7)
+Defined in: [packages/extensions/src/error.ts:7](https://github.com/Xunnamius/black-flag/blob/65863debdad33d702508c3459cced432c1437abf/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/3764563cebc186c7e5f9e6fd9ad3d54a1192fe57/packages/extensions/src/error.ts#L8)
+Defined in: [packages/extensions/src/error.ts:8](https://github.com/Xunnamius/black-flag/blob/65863debdad33d702508c3459cced432c1437abf/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/3764563cebc186c7e5f9e6fd9ad3d54a1192fe57/packages/extensions/src/error.ts#L14)
+Defined in: [packages/extensions/src/error.ts:14](https://github.com/Xunnamius/black-flag/blob/65863debdad33d702508c3459cced432c1437abf/packages/extensions/src/error.ts#L14)
 
 A collection of possible error and warning messages.
 

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:1467](https://github.com/Xunnamius/black-flag/blob/3764563cebc186c7e5f9e6fd9ad3d54a1192fe57/packages/extensions/src/index.ts#L1467)
+Defined in: [packages/extensions/src/index.ts:1472](https://github.com/Xunnamius/black-flag/blob/65863debdad33d702508c3459cced432c1437abf/packages/extensions/src/index.ts#L1472)
 
 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/3764563cebc186c7e5f9e6fd9ad3d54a1192fe57/packages/extensions/src/index.ts#L749)
+Defined in: [packages/extensions/src/index.ts:749](https://github.com/Xunnamius/black-flag/blob/65863debdad33d702508c3459cced432c1437abf/packages/extensions/src/index.ts#L749)
 
 This function enables several additional options-related units of
 functionality via analysis of the returned options configuration object and

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

@@ -6,22 +6,31 @@
 
 # Function: withUsageExtensions()
 
-> **withUsageExtensions**(`altDescription`, `__namedParameters`): `string`
+> **withUsageExtensions**(`__namedParameters`): `string`
 
-Defined in: [packages/extensions/src/index.ts:1379](https://github.com/Xunnamius/black-flag/blob/3764563cebc186c7e5f9e6fd9ad3d54a1192fe57/packages/extensions/src/index.ts#L1379)
+Defined in: [packages/extensions/src/index.ts:1379](https://github.com/Xunnamius/black-flag/blob/65863debdad33d702508c3459cced432c1437abf/packages/extensions/src/index.ts#L1379)
 
 Generate command usage text consistently yet flexibly.
 
 Defaults to: `Usage: $000\n\n${altDescription}` where `altDescription` is
-`$1.`
+`"$1."`.
 
 ## Parameters
 
-### altDescription
+### \_\_namedParameters
+
+#### altDescription?
 
 `string` = `'$1.'`
 
-### \_\_namedParameters
+The result of calling this function defaults to: `Usage:
+$000\n\n${altDescription}`.
+
+**Default**
+
+```ts
+"$1."
+```
 
 #### appendPeriod?
 

packages/extensions/docs/index/type-aliases/AsStrictExecutionContext.md

@@ -8,7 +8,7 @@
 
 > **AsStrictExecutionContext**\<`CustomExecutionContext`\> = `OmitIndexSignature`\<`Exclude`\<`CustomExecutionContext`, `"state"`\>\> & `OmitIndexSignature`\<`CustomExecutionContext`\[`"state"`\]\>
 
-Defined in: [packages/extensions/src/index.ts:631](https://github.com/Xunnamius/black-flag/blob/3764563cebc186c7e5f9e6fd9ad3d54a1192fe57/packages/extensions/src/index.ts#L631)
+Defined in: [packages/extensions/src/index.ts:631](https://github.com/Xunnamius/black-flag/blob/65863debdad33d702508c3459cced432c1437abf/packages/extensions/src/index.ts#L631)
 
 A stricter version of Black Flag's
 [ExecutionContext](https://github.com/Xunnamius/black-flag/blob/main/docs/api/src/exports/util/type-aliases/ExecutionContext.md)

packages/extensions/docs/index/type-aliases/BfBuilderFunction.md

@@ -8,7 +8,7 @@
 
 > **BfBuilderFunction**\<`CustomCliArguments`, `CustomExecutionContext`\> = `Extract`\<`Configuration`\<`CustomCliArguments`, `CustomExecutionContext`\>\[`"builder"`\], `Function`\>
 
-Defined in: [packages/extensions/src/index.ts:169](https://github.com/Xunnamius/black-flag/blob/3764563cebc186c7e5f9e6fd9ad3d54a1192fe57/packages/extensions/src/index.ts#L169)
+Defined in: [packages/extensions/src/index.ts:169](https://github.com/Xunnamius/black-flag/blob/65863debdad33d702508c3459cced432c1437abf/packages/extensions/src/index.ts#L169)
 
 The function type of the `builder` export accepted by Black Flag.