release: @black-flag/core@2.0.0 [skip ci]

## 💥 BREAKING CHANGES 💥

- **Positionals are now available to builders alongside all other flags**

  This is how vanilla Yargs does it. In earlier versions, builders' `argv` param had all positionals dumped into `argv._` due to a suboptimal parsing extension.

- **Show any available child commands in ALL error text**

  This includes when trying to use a command that is not found.

- **Do not output entire help text when a command fails**

  Skip all but the first line of `usage` text in output by default.

- **Upgrade `ExecutionContext::state.showHelpOnFail` to allow configuration of help text output style**

  New output style options include "short" (first line of `usage` only, this is now the default) and "full" (full `usage` string). Also allows configuration of which error kinds trigger help text output and which do not. See documentation for details.

- **Surface new `CliError::showHelp` parameter values**

  - `"short"`/`true`, which will print the command help text without all but the first line of `usage` text.

  - `"default"`, which will defer to `ExecutionContext::state.showHelpOnFail`.

  - `"full"`, which will force the old functionality.

  - `false`, which ensures help text is never printed with respect to the current error instance.

- **Better help text output for dynamic options**

  With this change, Black Flag lets Yargs fully parse `argv` and run through the builder twice before bailing to print help text when `--help` (or the equivalent option) is given.

  This allows input that triggers dynamic options like `my-command --flag-1 --flag-2 --help` to show help text specific to the final resolved builder configurations of `--flag-1 --flag-2` rather than always showing the most generic help text, which was the behavior of older Black Flag versions. See documentation for details.

- `$executionContext` and `$artificiallyInvoked` symbols are now drawn from the global symbol registry. They will not match symbols from previous versions!

- **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`.

- **Along with implementing the `errorHandlingBehavior` DX improvement in `makeRunner`, this update also addresses several small discrepancies in the behavior of `configureProgram`, `runProgram`, and `makeRunner`. These functions should now behave identically where appropriate (i.e. as described in their documentation), including consistently triggering the same error handling behavior at the same points for the same reasons given the same inputs.**

  Additionally, non-graceful errors that are not handled by `ConfigureErrorHandlingEpilogue` will be consistently presented to the user as framework errors (assertion failures). As such, `runProgram` (and the low-order function returned by `makeRunner`) should no longer throw in some edge cases, such as when being passed a rejected promise or when a hook that is evaluated early throws.

- `ErrorMessage` export was renamed to `BfErrorMessage`

## ✨ Features

- **src:** export `getDeepestErrorCause` under `/util` ([bf001c4][2])
- **src:** implement `errorHandlingBehavior` option in `makeRunner` ([5e4eb3d][3])
- **src:** make `expectedHelpTextRegExp` utility a public export ([8f2cb13][4])
- **src:** make positionals available to builders normally (no longer in `argv._`) ([42367ce][5])
- **src:** output help text with greater fidelity ([02a497f][6]) <sup>see [#172][7]</sup>
- Support Windows-style paths ([cd288c5][8])

## 🪄 Fixes

- Fix Windows interop issues ([b3abf95][9]) <sup>see [#174][10]</sup>
- **package:** add @types/yargs as production dependency ([8d50a56][11])
- **src:** ensure ESM file bare exports are seen by black flag ([389a2dc][12])
- **src:** fix node\@18 interop issue ([c1b5f61][13]) <sup>see [#173][14]</sup>
- **src:** improve `isX` type assertion exports ([b980544][15])
- **src:** improve intellisense across various exports ([d6b1e73][16])
- **src:** more consistently handle various errors; improve output fidelity ([9412aa6][17])
- **src:** throw upon encountering a `command` export with invalid yargs DSL ([7312b8d][18])
- **src:** throw upon encountering an async `builder` export ([78eb0a2][19])

## ⚙️ Build System

- **deps:** bump type-fest from 4.35.0 to 4.36.0 ([33b2099][20])
- **deps:** bump type-fest from 4.36.0 to 4.37.0 ([cdd8f61][21])
- **husky:** force lint-staged (via husky) to only use global config file ([5d3f2cc][22])
- **package:** add @-xun/symbiote dev dependency ([074a930][23])
- **package:** prune unnecessary dependencies ([1b5cdbf][24])
- Throw in `runProgram` when an incompatible Node.js runtime version is detected ([cb56f8d][25])

## 🧙🏿 Refactored

- Make exported symbols cross-realm ([af78a8f][26])
- Rename and restructure exports for better docs generation ([8303ba7][27])
- **src:** `ErrorMessage` export is now `BfErrorMessage` ([3918a29][28])

[1]: https://github.com/Xunnamius/black-flag/compare/@black-flag/core@1.3.2...@black-flag/core@2.0.0
[2]: bf001c4
[3]: 5e4eb3d
[4]: 8f2cb13
[5]: 42367ce
[6]: 02a497f
[7]: #172
[8]: cd288c5
[9]: b3abf95
[10]: #174
[11]: 8d50a56
[12]: 389a2dc
[13]: c1b5f61
[14]: #173
[15]: b980544
[16]: d6b1e73
[17]: 9412aa6
[18]: 7312b8d
[19]: 78eb0a2
[20]: 33b2099
[21]: cdd8f61
[22]: 5d3f2cc
[23]: 074a930
[24]: 1b5cdbf
[25]: cb56f8d
[26]: af78a8f
[27]: 8303ba7
[28]: 3918a29

Author: Xunnamius

CHANGELOG.md

@@ -6,7 +6,7 @@
 
 # Class: CliError
 
-Defined in: [src/error.ts:156](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/error.ts#L156)
+Defined in: [src/error.ts:156](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/error.ts#L156)
 
 Represents a CLI-specific error with suggested exit code and other
 properties. As `CliError` has built-in support for cause chaining, this class
@@ -33,7 +33,7 @@ can be used as a simple wrapper around other errors.
 
 > **new CliError**(`reason`?, `options`?): [`CliError`](CliError.md)
 
-Defined in: [src/error.ts:169](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/error.ts#L169)
+Defined in: [src/error.ts:169](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/error.ts#L169)
 
 Represents a CLI-specific error, optionally with suggested exit code and
 other context.
@@ -60,7 +60,7 @@ other context.
 
 > **new CliError**(`reason`, `options`, `message`, `superOptions`): [`CliError`](CliError.md)
 
-Defined in: [src/error.ts:174](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/error.ts#L174)
+Defined in: [src/error.ts:174](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/error.ts#L174)
 
 This constructor syntax is used by subclasses when calling this constructor
 via `super`.
@@ -97,7 +97,7 @@ via `super`.
 
 > **\[$type\]**: `string`[]
 
-Defined in: [src/error.ts:164](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/error.ts#L164)
+Defined in: [src/error.ts:164](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/error.ts#L164)
 
 ***
 
@@ -121,7 +121,7 @@ Defined in: node\_modules/typescript/lib/lib.es2022.error.d.ts:26
 
 > **dangerouslyFatal**: `boolean` = `false`
 
-Defined in: [src/error.ts:162](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/error.ts#L162)
+Defined in: [src/error.ts:162](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/error.ts#L162)
 
 This option is similar in intent to Yargs's `exitProcess()` function,
 except applied more granularly.
@@ -186,7 +186,7 @@ Defined in: node\_modules/typescript/lib/lib.es5.d.ts:1076
 
 > **showHelp**: `NonNullable`\<`undefined` \| `false` \| `"full"` \| `"short"` \| `"default"`\>
 
-Defined in: [src/error.ts:161](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/error.ts#L161)
+Defined in: [src/error.ts:161](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/error.ts#L161)
 
 If `showHelp` is set to a string that isn't `"default"`, help text will be
 sent to stderr. Note that help text is always sent _before this exception
@@ -237,7 +237,7 @@ Defined in: node\_modules/typescript/lib/lib.es5.d.ts:1078
 
 > **suggestedExitCode**: [`FrameworkExitCode`](../enumerations/FrameworkExitCode.md) = `FrameworkExitCode.DefaultError`
 
-Defined in: [src/error.ts:160](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/error.ts#L160)
+Defined in: [src/error.ts:160](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/error.ts#L160)
 
 The exit code that will be returned when the application exits, given
 nothing else goes wrong in the interim.

docs/api/src/exports/classes/CliError.md

@@ -6,7 +6,7 @@
 
 # Class: GracefulEarlyExitError
 
-Defined in: [src/error.ts:246](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/error.ts#L246)
+Defined in: [src/error.ts:246](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/error.ts#L246)
 
 Represents an exceptional event that should result in the immediate
 termination of the application but with an exit code indicating success
@@ -25,7 +25,7 @@ ignored.
 
 > **new GracefulEarlyExitError**(`error`?, `options`?): [`GracefulEarlyExitError`](GracefulEarlyExitError.md)
 
-Defined in: [src/error.ts:257](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/error.ts#L257)
+Defined in: [src/error.ts:257](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/error.ts#L257)
 
 Represents an exceptional event that should result in the immediate
 termination of the application but with an exit code indicating success
@@ -58,7 +58,7 @@ ignored.
 
 > **\[$type\]**: `string`[]
 
-Defined in: [src/error.ts:248](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/error.ts#L248)
+Defined in: [src/error.ts:248](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/error.ts#L248)
 
 #### Overrides
 
@@ -82,7 +82,7 @@ Defined in: node\_modules/typescript/lib/lib.es2022.error.d.ts:26
 
 > **dangerouslyFatal**: `boolean` = `false`
 
-Defined in: [src/error.ts:162](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/error.ts#L162)
+Defined in: [src/error.ts:162](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/error.ts#L162)
 
 This option is similar in intent to Yargs's `exitProcess()` function,
 except applied more granularly.
@@ -147,7 +147,7 @@ Defined in: node\_modules/typescript/lib/lib.es5.d.ts:1076
 
 > **showHelp**: `NonNullable`\<`undefined` \| `false` \| `"full"` \| `"short"` \| `"default"`\>
 
-Defined in: [src/error.ts:161](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/error.ts#L161)
+Defined in: [src/error.ts:161](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/error.ts#L161)
 
 If `showHelp` is set to a string that isn't `"default"`, help text will be
 sent to stderr. Note that help text is always sent _before this exception
@@ -198,7 +198,7 @@ Defined in: node\_modules/typescript/lib/lib.es5.d.ts:1078
 
 > **suggestedExitCode**: [`FrameworkExitCode`](../enumerations/FrameworkExitCode.md) = `FrameworkExitCode.DefaultError`
 
-Defined in: [src/error.ts:160](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/error.ts#L160)
+Defined in: [src/error.ts:160](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/error.ts#L160)
 
 The exit code that will be returned when the application exits, given
 nothing else goes wrong in the interim.

docs/api/src/exports/classes/GracefulEarlyExitError.md

@@ -6,7 +6,7 @@
 
 # Enumeration: FrameworkExitCode
 
-Defined in: [src/constant.ts:51](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/constant.ts#L51)
+Defined in: [src/constant.ts:51](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/constant.ts#L51)
 
 Well-known exit codes shared across CLI implementations.
 
@@ -16,7 +16,7 @@ Well-known exit codes shared across CLI implementations.
 
 > **AssertionFailed**: `3`
 
-Defined in: [src/constant.ts:75](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/constant.ts#L75)
+Defined in: [src/constant.ts:75](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/constant.ts#L75)
 
 The exit code used when a sanity check fails. This includes (but is not
 limited to) all _framework errors_.
@@ -34,7 +34,7 @@ of Black Flag by the developer.
 
 > **DefaultError**: `1`
 
-Defined in: [src/constant.ts:59](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/constant.ts#L59)
+Defined in: [src/constant.ts:59](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/constant.ts#L59)
 
 Hard-coded default fallback exit code when fatal errors occur.
 
@@ -44,7 +44,7 @@ Hard-coded default fallback exit code when fatal errors occur.
 
 > **NotImplemented**: `2`
 
-Defined in: [src/constant.ts:63](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/constant.ts#L63)
+Defined in: [src/constant.ts:63](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/constant.ts#L63)
 
 The exit code used when executing an unimplemented child command.
 
@@ -54,6 +54,6 @@ The exit code used when executing an unimplemented child command.
 
 > **Ok**: `0`
 
-Defined in: [src/constant.ts:55](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/constant.ts#L55)
+Defined in: [src/constant.ts:55](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/constant.ts#L55)
 
 The exit code used when execution succeeds and exits gracefully.

docs/api/src/exports/enumerations/FrameworkExitCode.md

@@ -8,7 +8,7 @@
 
 > **configureProgram**(`commandModulesPath`, `configurationHooks`?): `Promise`\<[`PreExecutionContext`](../util/type-aliases/PreExecutionContext.md)\>
 
-Defined in: [src/index.ts:188](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/index.ts#L188)
+Defined in: [src/index.ts:188](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/index.ts#L188)
 
 Create and return a [PreExecutionContext](../util/type-aliases/PreExecutionContext.md) containing fully-configured
 [Program](../util/type-aliases/Program.md) instances and an [Executor](../util/type-aliases/Executor.md) entry point function.

docs/api/src/exports/functions/configureProgram.md

@@ -8,7 +8,7 @@
 
 > **isCliError**(`parameter`): `parameter is CliError`
 
-Defined in: [src/error.ts:33](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/error.ts#L33)
+Defined in: [src/error.ts:33](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/error.ts#L33)
 
 Type guard for [CliError](../classes/CliError.md).
 

docs/api/src/exports/functions/isCliError.md

@@ -8,7 +8,7 @@
 
 > **isGracefulEarlyExitError**(`parameter`): `parameter is GracefulEarlyExitError`
 
-Defined in: [src/error.ts:46](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/error.ts#L46)
+Defined in: [src/error.ts:46](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/error.ts#L46)
 
 Type guard for [GracefulEarlyExitError](../classes/GracefulEarlyExitError.md).
 

docs/api/src/exports/functions/isGracefulEarlyExitError.md

@@ -10,7 +10,7 @@
 
 > **runProgram**\<`CustomCliArguments`\>(`commandModulesPath`): [`RunProgramReturnType`](../type-aliases/RunProgramReturnType.md)\<`CustomCliArguments`\>
 
-Defined in: [src/index.ts:674](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/index.ts#L674)
+Defined in: [src/index.ts:674](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/index.ts#L674)
 
 Invokes the dynamically imported
 `configureProgram(commandModulesPath).execute()` function.
@@ -46,7 +46,7 @@ if any other exception occurs, or `Arguments` otherwise.
 
 > **runProgram**\<`CustomCliArguments`\>(`commandModulesPath`, `configurationHooks`): [`RunProgramReturnType`](../type-aliases/RunProgramReturnType.md)\<`CustomCliArguments`\>
 
-Defined in: [src/index.ts:694](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/index.ts#L694)
+Defined in: [src/index.ts:694](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/index.ts#L694)
 
 Invokes the dynamically imported `configureProgram(commandModulesPath,
 configurationHooks).execute()` function.
@@ -86,7 +86,7 @@ if any other exception occurs, or `Arguments` otherwise.
 
 > **runProgram**\<`CustomCliArguments`\>(`commandModulesPath`, `preExecutionContext`): [`RunProgramReturnType`](../type-aliases/RunProgramReturnType.md)\<`CustomCliArguments`\>
 
-Defined in: [src/index.ts:718](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/index.ts#L718)
+Defined in: [src/index.ts:718](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/index.ts#L718)
 
 Invokes the `preExecutionContext.execute()` function.
 
@@ -127,7 +127,7 @@ if any other exception occurs, or `Arguments` otherwise.
 
 > **runProgram**\<`CustomCliArguments`\>(`commandModulesPath`, `argv`): [`RunProgramReturnType`](../type-aliases/RunProgramReturnType.md)\<`CustomCliArguments`\>
 
-Defined in: [src/index.ts:742](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/index.ts#L742)
+Defined in: [src/index.ts:742](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/index.ts#L742)
 
 Invokes the dynamically imported
 `configureProgram(commandModulesPath).execute(argv)` function. If `argv` is a
@@ -168,7 +168,7 @@ if any other exception occurs, or `Arguments` otherwise.
 
 > **runProgram**\<`CustomCliArguments`\>(`commandModulesPath`, `argv`, `configurationHooks`): [`RunProgramReturnType`](../type-aliases/RunProgramReturnType.md)\<`CustomCliArguments`\>
 
-Defined in: [src/index.ts:766](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/index.ts#L766)
+Defined in: [src/index.ts:766](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/index.ts#L766)
 
 Invokes the dynamically imported `configureProgram(commandModulesPath,
 configurationHooks).execute(argv)` function. If `argv` is a string, `argv =
@@ -213,7 +213,7 @@ if any other exception occurs, or `Arguments` otherwise.
 
 > **runProgram**\<`CustomCliArguments`\>(`commandModulesPath`, `argv`, `preExecutionContext`): [`RunProgramReturnType`](../type-aliases/RunProgramReturnType.md)\<`CustomCliArguments`\>
 
-Defined in: [src/index.ts:792](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/index.ts#L792)
+Defined in: [src/index.ts:792](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/index.ts#L792)
 
 Invokes the `preExecutionContext.execute(argv)` function. If `argv` is a
 string, `argv = argv.split(' ')` is applied first.
@@ -259,7 +259,7 @@ if any other exception occurs, or `Arguments` otherwise.
 
 > **runProgram**\<`CustomCliArguments`\>(...`args`): [`RunProgramReturnType`](../type-aliases/RunProgramReturnType.md)\<`CustomCliArguments`\>
 
-Defined in: [src/index.ts:812](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/index.ts#L812)
+Defined in: [src/index.ts:812](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/index.ts#L812)
 
 Run the given program with the configuration given in `args`.
 

docs/api/src/exports/functions/runProgram.md

@@ -8,7 +8,7 @@
 
 > **Arguments**\<`CustomCliArguments`, `CustomExecutionContext`\>: `_Arguments`\<[`FrameworkArguments`](../util/type-aliases/FrameworkArguments.md)\<`CustomExecutionContext`\> & `CustomCliArguments`\>
 
-Defined in: [src/types/program.ts:29](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/types/program.ts#L29)
+Defined in: [src/types/program.ts:29](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/types/program.ts#L29)
 
 Represents the parsed CLI arguments, plus `_` and `$0`, any (hidden)
 arguments/properties specific to Black Flag, and an indexer falling back to

docs/api/src/exports/type-aliases/Arguments.md

@@ -8,7 +8,7 @@
 
 > **ChildConfiguration**\<`CustomCliArguments`, `CustomExecutionContext`\>: `Partial`\<[`Configuration`](Configuration.md)\<`CustomCliArguments`, `CustomExecutionContext`\>\>
 
-Defined in: [src/types/module.ts:170](https://github.com/Xunnamius/black-flag/blob/10cd0ebc0304d033218ec4dffba0c41cb2e85ff6/src/types/module.ts#L170)
+Defined in: [src/types/module.ts:170](https://github.com/Xunnamius/black-flag/blob/aaa1a74457790f285cb2c85d4d6a7ee05978fc42/src/types/module.ts#L170)
 
 A partial extension to the [Configuration](Configuration.md) interface for child
 configurations. This type was designed for use in external ESM/CJS module