release: @black-flag/[email protected] [skip ci]

## ✨ Features

- **packages/extensions:** implement `enableAutomaticSorting` option for `withBuilderExtensions` ([3b93860][2]) <sup>see [#182][3]</sup>

## 🪄 Fixes

- **packages/extensions:** fix `getInvocableExtendedHandler` contextual "cross-talk" issue ([1adf708][4]) <sup>see [#175][5]</sup>

## ⚙️ Build System

- **deps:** bump core-js from 3.40.0 to 3.41.0 ([12658b9][6])
- **deps:** bump core-js from 3.40.0 to 3.41.0 ([9371719][7])

[1]: https://github.com/Xunnamius/black-flag/compare/@black-flag/[email protected]...@black-flag/[email protected]
[2]: 3b93860
[3]: #182
[4]: 1adf708
[5]: #175
[6]: 12658b9
[7]: 9371719

Author: Xunnamius

Diff for: packages/extensions/CHANGELOG.md

@@ -6,57 +6,86 @@ this project adheres to [Semantic Versioning][2].
 
 <br />
 
-## @black-flag/extensions[@2.0.0][3] (2025-03-14)
+## @black-flag/extensions[@2.1.0][3] (2025-03-17)
 
-### 💥 BREAKING CHANGES 💥
+### ✨ Features
 
-- `$executionContext` and `$artificiallyInvoked` symbols are now drawn from the global symbol registry. They will not match symbols from previous versions!
+- **packages/extensions:** implement `enableAutomaticSorting` option for `withBuilderExtensions` ([3b93860][4]) <sup>see [#182][5]</sup>
+
+### 🪄 Fixes
+
+- **packages/extensions:** fix `getInvocableExtendedHandler` contextual "cross-talk" issue ([1adf708][6]) <sup>see [#175][7]</sup>
+
+### ⚙️ Build System
+
+- **deps:** bump core-js from 3.40.0 to 3.41.0 ([12658b9][8])
+- **deps:** bump core-js from 3.40.0 to 3.41.0 ([9371719][9])
+
+<br />
+
+## @black-flag/extensions[@2.0.0][10] (2025-03-14)
+
+### 💥 BREAKING CHANGES 💥
 
 - **All instances in source where `commandModulePath` appeared have been replaced by `commandModulesPath`. This includes the call signatures of functions like `makeRunner`.**
 
   The fix is simple: find-and-replace all instances of `commandModulePath` with `commandModulesPath`.
 
+- `$executionContext` and `$artificiallyInvoked` symbols are now drawn from the global symbol registry. They will not match symbols from previous versions!
+
 ### ✨ Features
 
-- **packages/extensions:** implement @black-flag/extensions ([f0525c5][4])
+- **packages/extensions:** implement @black-flag/extensions ([f0525c5][11])
 
 ### 🪄 Fixes
 
-- Fix Windows interop issues ([b3abf95][5]) <sup>see [#174][6]</sup>
+- Fix Windows interop issues ([b3abf95][12]) <sup>see [#174][13]</sup>
 
 ### ⚙️ Build System
 
-- **deps:** bump type-fest from 4.35.0 to 4.36.0 ([80350cc][7])
-- **deps:** bump type-fest from 4.36.0 to 4.37.0 ([7c8ff7a][8])
-- **husky:** force lint-staged (via husky) to only use global config file ([5d3f2cc][9])
-- **packages/extensions:** use correct git repo metadata in package.json ([0548f8f][10])
+- **deps:** bump type-fest from 4.35.0 to 4.36.0 ([80350cc][14])
+- **deps:** bump type-fest from 4.36.0 to 4.37.0 ([7c8ff7a][15])
+- **husky:** force lint-staged (via husky) to only use global config file ([5d3f2cc][16])
+- **packages/extensions:** use correct git repo metadata in package.json ([0548f8f][17])
 
 ### 🧙🏿 Refactored
 
-- Make exported symbols cross-realm ([af78a8f][11])
-- Rename and restructure exports for better docs generation ([8303ba7][12])
+- Make exported symbols cross-realm ([af78a8f][18])
+- Rename and restructure exports for better docs generation ([8303ba7][19])
+
+### 🔥 Reverted
+
+- _"build(deps): bump core-js from 3.40.0 to 3.41.0"_ ([aebeab7][20])
 
-## @black-flag/extensions[@1.0.2][13] (2025-02-21)
+## @black-flag/extensions[@1.0.2][21] (2025-02-21)
 
 #### ⚙️ Build System
 
-- **husky:** update to latest hooks ([75d5c66][14])
-- **tsconfig:** fix internal path resolution ([fbe3a69][15])
-- **tsconfig:** upgrade to NodeNext ([d3a499e][16])
+- **husky:** update to latest hooks ([75d5c66][22])
+- **tsconfig:** fix internal path resolution ([fbe3a69][23])
+- **tsconfig:** upgrade to NodeNext ([d3a499e][24])
 
 [1]: https://conventionalcommits.org
 [2]: https://semver.org
-[3]: https://github.com/Xunnamius/black-flag/compare/@black-flag/[email protected]...@black-flag/[email protected]
-[4]: https://github.com/Xunnamius/black-flag/commit/f0525c5f4bf72b0f28fedf4f6d66f4a1b7353b05
-[5]: https://github.com/Xunnamius/black-flag/commit/b3abf95ca2958d5d2fca1091178c050ef88fe5f5
-[6]: https://github.com/Xunnamius/black-flag/issues/174
-[7]: https://github.com/Xunnamius/black-flag/commit/80350cca61bef915d737fb097e4e3838118a1167
-[8]: https://github.com/Xunnamius/black-flag/commit/7c8ff7ad8ffd4d822329278da0a21db54f904f25
-[9]: https://github.com/Xunnamius/black-flag/commit/5d3f2ccdfcd615917892d27a5c2cfa1b28879e0c
-[10]: https://github.com/Xunnamius/black-flag/commit/0548f8fe3c7daa363173184e34f2307f8964dbed
-[11]: https://github.com/Xunnamius/black-flag/commit/af78a8fbc5839e0d3db1b07312bbc854ef1b7a0d
-[12]: https://github.com/Xunnamius/black-flag/commit/8303ba7f438ae7f7dedfc2b6f5fd396cab32b252
-[13]: https://github.com/Xunnamius/black-flag/compare/d3a499e7aeddf23d392479b2cf99cc98bce8226f...@black-flag/[email protected]
-[14]: https://github.com/Xunnamius/black-flag/commit/75d5c66bcce8f0c2c139962f7ddd28aa0c9499d7
-[15]: https://github.com/Xunnamius/black-flag/commit/fbe3a699a9063ed7da08311a22fe798672583b0f
-[16]: https://github.com/Xunnamius/black-flag/commit/d3a499e7aeddf23d392479b2cf99cc98bce8226f
+[3]: https://github.com/Xunnamius/black-flag/compare/@black-flag/[email protected]...@black-flag/[email protected]
+[4]: https://github.com/Xunnamius/black-flag/commit/3b9386082ffb4c7b2987c0f2b2e00e6cd48ad4bb
+[5]: https://github.com/Xunnamius/black-flag/issues/182
+[6]: https://github.com/Xunnamius/black-flag/commit/1adf7086f5837a4166d7bdfc87028a031d772480
+[7]: https://github.com/Xunnamius/black-flag/issues/175
+[8]: https://github.com/Xunnamius/black-flag/commit/12658b92d7bda44a0105775dae2db2cb0a1fcdee
+[9]: https://github.com/Xunnamius/black-flag/commit/937171967cd8887a8aba12cbb23c0adffacc6c78
+[10]: https://github.com/Xunnamius/black-flag/compare/@black-flag/[email protected]...@black-flag/[email protected]
+[11]: https://github.com/Xunnamius/black-flag/commit/f0525c5f4bf72b0f28fedf4f6d66f4a1b7353b05
+[12]: https://github.com/Xunnamius/black-flag/commit/b3abf95ca2958d5d2fca1091178c050ef88fe5f5
+[13]: https://github.com/Xunnamius/black-flag/issues/174
+[14]: https://github.com/Xunnamius/black-flag/commit/80350cca61bef915d737fb097e4e3838118a1167
+[15]: https://github.com/Xunnamius/black-flag/commit/7c8ff7ad8ffd4d822329278da0a21db54f904f25
+[16]: https://github.com/Xunnamius/black-flag/commit/5d3f2ccdfcd615917892d27a5c2cfa1b28879e0c
+[17]: https://github.com/Xunnamius/black-flag/commit/0548f8fe3c7daa363173184e34f2307f8964dbed
+[18]: https://github.com/Xunnamius/black-flag/commit/af78a8fbc5839e0d3db1b07312bbc854ef1b7a0d
+[19]: https://github.com/Xunnamius/black-flag/commit/8303ba7f438ae7f7dedfc2b6f5fd396cab32b252
+[20]: https://github.com/Xunnamius/black-flag/commit/aebeab7d2567bc70eedd5920ea51c02bfe3dc081
+[21]: https://github.com/Xunnamius/black-flag/compare/d3a499e7aeddf23d392479b2cf99cc98bce8226f...@black-flag/[email protected]
+[22]: https://github.com/Xunnamius/black-flag/commit/75d5c66bcce8f0c2c139962f7ddd28aa0c9499d7
+[23]: https://github.com/Xunnamius/black-flag/commit/fbe3a699a9063ed7da08311a22fe798672583b0f
+[24]: https://github.com/Xunnamius/black-flag/commit/d3a499e7aeddf23d392479b2cf99cc98bce8226f

Diff for: 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/dca16a7cbf43b7d8428fc9b34cc49fc69b7b6672/packages/extensions/src/constant.ts#L4)
+Defined in: [packages/extensions/src/constant.ts:4](https://github.com/Xunnamius/black-flag/blob/fc8d2f90ceaae2703f3b3ef20b36ffbe269cca3b/packages/extensions/src/constant.ts#L4)
 
 The project-wide namespace that appears in debugger output.

Diff for: packages/extensions/docs/error/type-aliases/KeyValueEntries.md

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

Diff for: 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/dca16a7cbf43b7d8428fc9b34cc49fc69b7b6672/packages/extensions/src/error.ts#L8)
+Defined in: [packages/extensions/src/error.ts:8](https://github.com/Xunnamius/black-flag/blob/fc8d2f90ceaae2703f3b3ef20b36ffbe269cca3b/packages/extensions/src/error.ts#L8)

Diff for: 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/dca16a7cbf43b7d8428fc9b34cc49fc69b7b6672/packages/extensions/src/error.ts#L14)
+Defined in: [packages/extensions/src/error.ts:14](https://github.com/Xunnamius/black-flag/blob/fc8d2f90ceaae2703f3b3ef20b36ffbe269cca3b/packages/extensions/src/error.ts#L14)
 
 A collection of possible error and warning messages.
 

Diff for: 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:1440](https://github.com/Xunnamius/black-flag/blob/dca16a7cbf43b7d8428fc9b34cc49fc69b7b6672/packages/extensions/src/index.ts#L1440)
+Defined in: [packages/extensions/src/index.ts:1440](https://github.com/Xunnamius/black-flag/blob/fc8d2f90ceaae2703f3b3ef20b36ffbe269cca3b/packages/extensions/src/index.ts#L1440)
 
 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

Diff for: 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:744](https://github.com/Xunnamius/black-flag/blob/dca16a7cbf43b7d8428fc9b34cc49fc69b7b6672/packages/extensions/src/index.ts#L744)
+Defined in: [packages/extensions/src/index.ts:744](https://github.com/Xunnamius/black-flag/blob/fc8d2f90ceaae2703f3b3ef20b36ffbe269cca3b/packages/extensions/src/index.ts#L744)
 
 This function enables several additional options-related units of
 functionality via analysis of the returned options configuration object and

Diff for: packages/extensions/docs/index/functions/withUsageExtensions.md

@@ -8,7 +8,7 @@
 
 > **withUsageExtensions**(`altDescription`, `__namedParameters`): `string`
 
-Defined in: [packages/extensions/src/index.ts:1368](https://github.com/Xunnamius/black-flag/blob/dca16a7cbf43b7d8428fc9b34cc49fc69b7b6672/packages/extensions/src/index.ts#L1368)
+Defined in: [packages/extensions/src/index.ts:1368](https://github.com/Xunnamius/black-flag/blob/fc8d2f90ceaae2703f3b3ef20b36ffbe269cca3b/packages/extensions/src/index.ts#L1368)
 
 Generate command usage text consistently yet flexibly.
 

Diff for: 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:626](https://github.com/Xunnamius/black-flag/blob/dca16a7cbf43b7d8428fc9b34cc49fc69b7b6672/packages/extensions/src/index.ts#L626)
+Defined in: [packages/extensions/src/index.ts:626](https://github.com/Xunnamius/black-flag/blob/fc8d2f90ceaae2703f3b3ef20b36ffbe269cca3b/packages/extensions/src/index.ts#L626)
 
 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)

Diff for: 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/dca16a7cbf43b7d8428fc9b34cc49fc69b7b6672/packages/extensions/src/index.ts#L169)
+Defined in: [packages/extensions/src/index.ts:169](https://github.com/Xunnamius/black-flag/blob/fc8d2f90ceaae2703f3b3ef20b36ffbe269cca3b/packages/extensions/src/index.ts#L169)
 
 The function type of the `builder` export accepted by Black Flag.
 

Diff for: packages/extensions/docs/index/type-aliases/BfBuilderObject.md

@@ -8,7 +8,7 @@
 
 > **BfBuilderObject**\<`CustomCliArguments`, `CustomExecutionContext`\> = `Exclude`\<`Configuration`\<`CustomCliArguments`, `CustomExecutionContext`\>\[`"builder"`\], `Function`\>
 
-Defined in: [packages/extensions/src/index.ts:181](https://github.com/Xunnamius/black-flag/blob/dca16a7cbf43b7d8428fc9b34cc49fc69b7b6672/packages/extensions/src/index.ts#L181)
+Defined in: [packages/extensions/src/index.ts:181](https://github.com/Xunnamius/black-flag/blob/fc8d2f90ceaae2703f3b3ef20b36ffbe269cca3b/packages/extensions/src/index.ts#L181)
 
 The object type of the `builder` export accepted by Black Flag.
 

Diff for: packages/extensions/docs/index/type-aliases/BfBuilderObjectValue.md

@@ -8,7 +8,7 @@
 
 > **BfBuilderObjectValue**\<`CustomCliArguments`, `CustomExecutionContext`\> = [`BfBuilderObject`](BfBuilderObject.md)\<`CustomCliArguments`, `CustomExecutionContext`\>\[`string`\]
 
-Defined in: [packages/extensions/src/index.ts:195](https://github.com/Xunnamius/black-flag/blob/dca16a7cbf43b7d8428fc9b34cc49fc69b7b6672/packages/extensions/src/index.ts#L195)
+Defined in: [packages/extensions/src/index.ts:195](https://github.com/Xunnamius/black-flag/blob/fc8d2f90ceaae2703f3b3ef20b36ffbe269cca3b/packages/extensions/src/index.ts#L195)
 
 The object value type of a [BfBuilderObject](BfBuilderObject.md).
 

Diff for: packages/extensions/docs/index/type-aliases/BfGenericBuilderObjectValue.md

@@ -8,6 +8,6 @@
 
 > **BfGenericBuilderObjectValue** = [`BfBuilderObjectValue`](BfBuilderObjectValue.md)\<`Record`\<`string`, `unknown`\>, `ExecutionContext`\>
 
-Defined in: [packages/extensions/src/index.ts:203](https://github.com/Xunnamius/black-flag/blob/dca16a7cbf43b7d8428fc9b34cc49fc69b7b6672/packages/extensions/src/index.ts#L203)
+Defined in: [packages/extensions/src/index.ts:203](https://github.com/Xunnamius/black-flag/blob/fc8d2f90ceaae2703f3b3ef20b36ffbe269cca3b/packages/extensions/src/index.ts#L203)
 
 The generic object value type of a [BfBuilderObject](BfBuilderObject.md).

Diff for: packages/extensions/docs/index/type-aliases/BfeBuilderFunction.md

@@ -8,7 +8,7 @@
 
 > **BfeBuilderFunction**\<`CustomCliArguments`, `CustomExecutionContext`\> = (...`args`) => [`BfBuilderObject`](BfBuilderObject.md)\<`CustomCliArguments`, `CustomExecutionContext`\>
 
-Defined in: [packages/extensions/src/index.ts:589](https://github.com/Xunnamius/black-flag/blob/dca16a7cbf43b7d8428fc9b34cc49fc69b7b6672/packages/extensions/src/index.ts#L589)
+Defined in: [packages/extensions/src/index.ts:589](https://github.com/Xunnamius/black-flag/blob/fc8d2f90ceaae2703f3b3ef20b36ffbe269cca3b/packages/extensions/src/index.ts#L589)
 
 This function implements several additional optionals-related units of
 functionality. This function is meant to take the place of a command's

Diff for: packages/extensions/docs/index/type-aliases/BfeBuilderObject.md

@@ -8,7 +8,7 @@
 
 > **BfeBuilderObject**\<`CustomCliArguments`, `CustomExecutionContext`\> = `object`
 
-Defined in: [packages/extensions/src/index.ts:212](https://github.com/Xunnamius/black-flag/blob/dca16a7cbf43b7d8428fc9b34cc49fc69b7b6672/packages/extensions/src/index.ts#L212)
+Defined in: [packages/extensions/src/index.ts:212](https://github.com/Xunnamius/black-flag/blob/fc8d2f90ceaae2703f3b3ef20b36ffbe269cca3b/packages/extensions/src/index.ts#L212)
 
 A version of the object type of the `builder` export accepted by Black Flag
 that supports BFE's additional functionality.

Diff for: packages/extensions/docs/index/type-aliases/BfeBuilderObjectValue.md

@@ -8,7 +8,7 @@
 
 > **BfeBuilderObjectValue**\<`CustomCliArguments`, `CustomExecutionContext`\> = [`BfeBuilderObjectValueWithoutExtensions`](BfeBuilderObjectValueWithoutExtensions.md) & [`BfeBuilderObjectValueExtensions`](BfeBuilderObjectValueExtensions.md)\<`CustomCliArguments`, `CustomExecutionContext`\>
 
-Defined in: [packages/extensions/src/index.ts:222](https://github.com/Xunnamius/black-flag/blob/dca16a7cbf43b7d8428fc9b34cc49fc69b7b6672/packages/extensions/src/index.ts#L222)
+Defined in: [packages/extensions/src/index.ts:222](https://github.com/Xunnamius/black-flag/blob/fc8d2f90ceaae2703f3b3ef20b36ffbe269cca3b/packages/extensions/src/index.ts#L222)
 
 The object value type of a [BfeBuilderObject](BfeBuilderObject.md).
 

Diff for: packages/extensions/docs/index/type-aliases/BfeBuilderObjectValueExtensionObject.md

@@ -8,7 +8,7 @@
 
 > **BfeBuilderObjectValueExtensionObject** = `Record`\<`string`, `unknown`\>
 
-Defined in: [packages/extensions/src/index.ts:470](https://github.com/Xunnamius/black-flag/blob/dca16a7cbf43b7d8428fc9b34cc49fc69b7b6672/packages/extensions/src/index.ts#L470)
+Defined in: [packages/extensions/src/index.ts:470](https://github.com/Xunnamius/black-flag/blob/fc8d2f90ceaae2703f3b3ef20b36ffbe269cca3b/packages/extensions/src/index.ts#L470)
 
 The object type of a [BfeBuilderObjectValueExtensions](BfeBuilderObjectValueExtensions.md).
 

Diff for: packages/extensions/docs/index/type-aliases/BfeBuilderObjectValueExtensionValue.md

@@ -8,7 +8,7 @@
 
 > **BfeBuilderObjectValueExtensionValue** = `string` \| [`BfeBuilderObjectValueExtensionObject`](BfeBuilderObjectValueExtensionObject.md) \| (`string` \| [`BfeBuilderObjectValueExtensionObject`](BfeBuilderObjectValueExtensionObject.md))[]
 
-Defined in: [packages/extensions/src/index.ts:460](https://github.com/Xunnamius/black-flag/blob/dca16a7cbf43b7d8428fc9b34cc49fc69b7b6672/packages/extensions/src/index.ts#L460)
+Defined in: [packages/extensions/src/index.ts:460](https://github.com/Xunnamius/black-flag/blob/fc8d2f90ceaae2703f3b3ef20b36ffbe269cca3b/packages/extensions/src/index.ts#L460)
 
 The string/object/array type of a [BfeBuilderObjectValueExtensions](BfeBuilderObjectValueExtensions.md).