@flowscripter/dynamic-cli-framework 1.7.4 → 2.0.0

package/dist/src/api/service/core/Table.js

@@ -1,49 +0,0 @@
-export default class Table {
-    rowCount;
-    columnCount;
-    options;
-    #columnOptions = new Map();
-    #rowOptions = new Map();
-    #cells = new Map();
-    constructor(rowCount, columnCount, options) {
-        this.rowCount = rowCount;
-        this.columnCount = columnCount;
-        this.options = options ?? {};
-    }
-    row(rowIndex, rowOptions) {
-        if (rowIndex < 0 || rowIndex >= this.rowCount) {
-            throw new Error(`Row index ${rowIndex} out of bounds [0, ${this.rowCount})`);
-        }
-        this.#rowOptions.set(rowIndex, rowOptions);
-        return this;
-    }
-    column(columnIndex, columnOptions) {
-        if (columnIndex < 0 || columnIndex >= this.columnCount) {
-            throw new Error(`Column index ${columnIndex} out of bounds [0, ${this.columnCount})`);
-        }
-        this.#columnOptions.set(columnIndex, columnOptions);
-        return this;
-    }
-    cell(rowIndex, columnIndex, contents, cellOptions) {
-        if (rowIndex < 0 || rowIndex >= this.rowCount) {
-            throw new Error(`Row index ${rowIndex} out of bounds [0, ${this.rowCount})`);
-        }
-        if (columnIndex < 0 || columnIndex >= this.columnCount) {
-            throw new Error(`Column index ${columnIndex} out of bounds [0, ${this.columnCount})`);
-        }
-        this.#cells.set(`${rowIndex},${columnIndex}`, {
-            contents,
-            options: cellOptions,
-        });
-        return this;
-    }
-    getColumnOptions(columnIndex) {
-        return this.#columnOptions.get(columnIndex);
-    }
-    getRowOptions(rowIndex) {
-        return this.#rowOptions.get(rowIndex);
-    }
-    getCell(rowIndex, columnIndex) {
-        return this.#cells.get(`${rowIndex},${columnIndex}`);
-    }
-}

package/dist/src/api/service/core/TableGeneratorService.d.ts

@@ -1,32 +0,0 @@
-export declare const TABLE_GENERATOR_SERVICE_ID = "@flowscripter/dynamic-cli-framework/table-generator-service";
-export declare enum Align {
-    LEFT = 0,
-    CENTER = 1,
-    RIGHT = 2
-}
-export interface TableOptions {
-    border?: boolean;
-    borderColor?: string;
-    borderBackgroundColor?: string;
-    padding?: number;
-    maxWidth?: number;
-    align?: Align;
-}
-export interface ColumnOptions {
-    flexWeight?: number;
-    minWidth?: number;
-    maxWidth?: number;
-    align?: Align;
-}
-export interface RowOptions {
-    align?: Align;
-}
-export interface CellOptions {
-    align?: Align;
-}
-export default interface TableGeneratorService {
-    createTable(rowCount: number, columnCount: number, options?: TableOptions): Table;
-    render(table: Table): string;
-}
-import type Table from "./Table.ts";
-//# sourceMappingURL=TableGeneratorService.d.ts.map

package/dist/src/api/service/core/TableGeneratorService.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TableGeneratorService.d.ts","sourceRoot":"","sources":["../../../../../src/api/service/core/TableGeneratorService.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,gEACwB,CAAC;AAEhE,oBAAY,KAAK;IACf,IAAI,IAAI;IACR,MAAM,IAAI;IACV,KAAK,IAAI;CACV;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,CAAC,OAAO,WAAW,qBAAqB;IAC5C,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC;IAClF,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;CAC9B;AAED,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC"}

package/dist/src/api/service/core/TableGeneratorService.js

@@ -1,7 +0,0 @@
-export const TABLE_GENERATOR_SERVICE_ID = "@flowscripter/dynamic-cli-framework/table-generator-service";
-export var Align;
-(function (Align) {
-    Align[Align["LEFT"] = 0] = "LEFT";
-    Align[Align["CENTER"] = 1] = "CENTER";
-    Align[Align["RIGHT"] = 2] = "RIGHT";
-})(Align || (Align = {}));

package/dist/src/api/service/core/TreePrinterService.d.ts

@@ -1,9 +0,0 @@
-export declare const TREE_PRINTER_SERVICE_ID = "@flowscripter/dynamic-cli-framework/tree-printer-service";
-export interface TreeNode {
-    label: string;
-    children?: Array<TreeNode | string>;
-}
-export default interface TreePrinterService {
-    print(node: TreeNode): string;
-}
-//# sourceMappingURL=TreePrinterService.d.ts.map

package/dist/src/api/service/core/TreePrinterService.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TreePrinterService.d.ts","sourceRoot":"","sources":["../../../../../src/api/service/core/TreePrinterService.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,6DAA6D,CAAC;AAElG,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,CAAC,OAAO,WAAW,kBAAkB;IACzC,KAAK,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;CAC/B"}

package/dist/src/api/service/core/TreePrinterService.js

@@ -1 +0,0 @@
-export const TREE_PRINTER_SERVICE_ID = "@flowscripter/dynamic-cli-framework/tree-printer-service";

package/dist/src/runtime/registry/CommandRegistry.d.ts

@@ -1,89 +0,0 @@
-import type GroupCommand from "../../api/command/GroupCommand.ts";
-import type SubCommand from "../../api/command/SubCommand.ts";
-import type GlobalCommand from "../../api/command/GlobalCommand.ts";
-import type GlobalModifierCommand from "../../api/command/GlobalModifierCommand.ts";
-import type Command from "../../api/command/Command.ts";
-/**
- * Interface used by a {@link CLI} to register {@link Command} instances.
- */
-export default interface CommandRegistry {
-    /**
-     * Get all registered {@link SubCommand} instances.
-     */
-    getSubCommands(): ReadonlyArray<SubCommand>;
-    /**
-     * Get all registered {@link GroupCommand} instances.
-     */
-    getGroupCommands(): ReadonlyArray<GroupCommand>;
-    /**
-     * Get all registered {@link GlobalCommand} instances.
-     */
-    getGlobalCommands(): ReadonlyArray<GlobalCommand>;
-    /**
-     * Get all registered {@link GlobalModifierCommand} instances.
-     */
-    getGlobalModifierCommands(): ReadonlyArray<GlobalModifierCommand>;
-    /**
-     * Get a registered {@link SubCommand} by name.
-     */
-    getSubCommandByName(name: string): SubCommand | undefined;
-    /**
-     * Get a registered {@link GroupCommand} by name.
-     */
-    getGroupCommandByName(name: string): GroupCommand | undefined;
-    /**
-     * Get a registered {@link GroupCommand} and member {@link SubCommand} by
-     * combined name e.g. `<group-command-name>:<member-sub-command-name>`.
-     */
-    getGroupCommandAndMemberSubCommandByJoinedName(getGroupCommandAndMemberSubCommandByName: string): {
-        groupCommand: GroupCommand;
-        command: SubCommand;
-    } | undefined;
-    /**
-     * Get a registered {@link GlobalCommand} by name.
-     */
-    getGlobalCommandByName(name: string): GlobalCommand | undefined;
-    /**
-     * Get a registered {@link GlobalCommand} by short alias.
-     */
-    /**
-     * Get a registered {@link GlobalModifierCommand} by name.
-     */
-    getGlobalModifierCommandByName(name: string): GlobalModifierCommand | undefined;
-    /**
-     * Get a registered {@link GlobalModifierCommand} by short alias.
-     */
-    /**
-     * Get a map of all registered {@link GroupCommand} and member {@link SubCommand} instance combinations by
-     * combined name e.g. `<group-command-name>:<member-sub-command-name>`.
-     */
-    getGroupAndMemberCommandsByJoinedName(): ReadonlyMap<string, {
-        groupCommand: GroupCommand;
-        command: SubCommand;
-    }>;
-    /**
-     * Get a map of all registered {@link GlobalModifierCommand} instances by name provided by the specified service.
-     */
-    getGlobalModifierCommandsByNameProvidedByService(serviceId: string): ReadonlyMap<string, GlobalModifierCommand>;
-    /**
-     * Get a map of all registered {@link GlobalModifierCommand} instances by short alias provided by the specified service.
-     */
-    getGlobalModifierCommandsByShortAliasProvidedByService(serviceId: string): ReadonlyMap<string, GlobalModifierCommand>;
-    /**
-     * Get a map of all registered {@link GlobalModifierCommand} instances by name not provided by a service.
-     */
-    getGlobalModifierCommandsByNameNotProvidedByService(): ReadonlyMap<string, GlobalModifierCommand>;
-    /**
-     * Get a map of all registered {@link GlobalModifierCommand} instances by short alias not provided by a service.
-     */
-    getGlobalModifierCommandsByShortAliasNotProvidedByService(): ReadonlyMap<string, GlobalModifierCommand>;
-    /**
-     * Get a map of all registered non-modifier {@link Command} instances by name.
-     */
-    getNonModifierCommandsByName(): ReadonlyMap<string, Command>;
-    /**
-     * Get a map of all registered {@link GlobalCommand} instances by short alias.
-     */
-    getGlobalCommandsByShortAlias(): ReadonlyMap<string, GlobalCommand>;
-}
-//# sourceMappingURL=CommandRegistry.d.ts.map

package/dist/src/runtime/registry/CommandRegistry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CommandRegistry.d.ts","sourceRoot":"","sources":["../../../../src/runtime/registry/CommandRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,mCAAmC,CAAC;AAClE,OAAO,KAAK,UAAU,MAAM,iCAAiC,CAAC;AAC9D,OAAO,KAAK,aAAa,MAAM,oCAAoC,CAAC;AACpE,OAAO,KAAK,qBAAqB,MAAM,4CAA4C,CAAC;AACpF,OAAO,KAAK,OAAO,MAAM,8BAA8B,CAAC;AAExD;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,eAAe;IACtC;;OAEG;IACH,cAAc,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;IAE5C;;OAEG;IACH,gBAAgB,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC;IAEhD;;OAEG;IACH,iBAAiB,IAAI,aAAa,CAAC,aAAa,CAAC,CAAC;IAElD;;OAEG;IACH,yBAAyB,IAAI,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAElE;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAE1D;;OAEG;IACH,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAE9D;;;OAGG;IACH,8CAA8C,CAC5C,wCAAwC,EAAE,MAAM,GAC/C;QAAE,YAAY,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,UAAU,CAAA;KAAE,GAAG,SAAS,CAAC;IAEnE;;OAEG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IAEhE;;OAEG;IAGH;;OAEG;IACH,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAAC;IAEhF;;OAEG;IAKH;;;OAGG;IACH,qCAAqC,IAAI,WAAW,CAClD,MAAM,EACN;QAAE,YAAY,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,UAAU,CAAA;KAAE,CACpD,CAAC;IAEF;;OAEG;IACH,gDAAgD,CAC9C,SAAS,EAAE,MAAM,GAChB,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAE9C;;OAEG;IACH,sDAAsD,CACpD,SAAS,EAAE,MAAM,GAChB,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAE9C;;OAEG;IACH,mDAAmD,IAAI,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAElG;;OAEG;IACH,yDAAyD,IAAI,WAAW,CACtE,MAAM,EACN,qBAAqB,CACtB,CAAC;IAEF;;OAEG;IACH,4BAA4B,IAAI,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE7D;;OAEG;IACH,6BAA6B,IAAI,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACrE"}

package/dist/src/runtime/registry/ServiceProviderRegistry.d.ts

@@ -1,11 +0,0 @@
-import type { ServiceProvider } from "../../api/service/ServiceProvider.ts";
-/**
- * Interface used by a {@link CLI} to register {@link ServiceProvider} instances.
- */
-export default interface ServiceProviderRegistry {
-    /**
-     * Return all {@link ServiceProvider} instances registered in order of descending {@link ServiceProvider.servicePriority}
-     */
-    getServiceProviders(): ReadonlyArray<ServiceProvider>;
-}
-//# sourceMappingURL=ServiceProviderRegistry.d.ts.map

package/dist/src/runtime/registry/ServiceProviderRegistry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ServiceProviderRegistry.d.ts","sourceRoot":"","sources":["../../../../src/runtime/registry/ServiceProviderRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAE5E;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,uBAAuB;IAC9C;;OAEG;IACH,mBAAmB,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC;CACvD"}

package/src/api/CLI.ts

@@ -1,17 +0,0 @@
-/**
- * Interface to be implemented by a CLI application.
- */
-import type RunResult from "./RunResult.ts";
-import type CLIConfig from "./CLIConfig.ts";
-
-export default interface CLI {
-  /**
-   * Run the CLI with the provided arguments which do not include the invoked executable name.
-   *
-   * @param args the arguments to parse.
-   * @param cliConfig the {@link CLIConfig} for the CLI application.
-   *
-   * @return result of parsing arguments and running appropriate {@link Command} instances.
-   */
-  run(args: ReadonlyArray<string>, cliConfig: CLIConfig): Promise<RunResult>;
-}

package/src/api/CLIConfig.ts

@@ -1,24 +0,0 @@
-/**
- * Interface specifying common configuration for a {@link CLI} application.
- */
-export default interface CLIConfig {
-  /**
-   * Name of the CLI application.
-   */
-  readonly name: string;
-
-  /**
-   * Optional description of the CLI application.
-   */
-  readonly description?: string;
-
-  /**
-   * Optional sub-message to display below the banner.
-   */
-  readonly subMessage?: string;
-
-  /**
-   * Version of the CLI application.
-   */
-  readonly version: string;
-}

package/src/api/Context.ts

@@ -1,25 +0,0 @@
-/**
- * Interface allowing a {@link CLI} to pass context to a {@link Command} instance.
- */
-import type CLIConfig from "./CLIConfig.ts";
-
-export default interface Context {
-  /**
-   * The {@link CLIConfig} in use by the {@link CLI}.
-   */
-  readonly cliConfig: CLIConfig;
-
-  /**
-   * Return the service identified by the specified ID.
-   *
-   * @param id the ID of the service to retrieve.
-   */
-  getServiceById(id: string): unknown;
-
-  /**
-   * Check if the specified service exists in the context.
-   *
-   * @param id the ID of the desired service.
-   */
-  doesServiceExist(id: string): boolean;
-}

package/src/api/RunResult.ts

@@ -1,158 +0,0 @@
-/**
- * State of a {@link CLI} after invocation.
- */
-import type Command from "./command/Command.ts";
-import type Argument from "./argument/Argument.ts";
-import type ComplexOption from "./argument/ComplexOption.ts";
-import type {
-  PopulatedArgumentValues,
-  PopulatedArgumentValueType,
-} from "./argument/ArgumentValueTypes.ts";
-
-export enum RunState {
-  /**
-   * Arguments were successfully parsed and the specified command(s) were successfully executed.
-   */
-  SUCCESS = 0,
-
-  /**
-   * The arguments supplied were invalid or could not be parsed.
-   */
-  PARSE_ERROR = 1,
-
-  /**
-   * Arguments were successfully parsed but no command was discovered.
-   */
-  NO_COMMAND = 2,
-
-  /**
-   * Arguments were successfully parsed and command(s) discovered but command execution failed.
-   */
-  EXECUTION_ERROR = 3,
-
-  /**
-   * General runtime error related to the framework.
-   */
-  RUNTIME_ERROR = 4,
-
-  /**
-   * Execution was interrupted by a signal (e.g. Ctrl-C or SIGTERM).
-   */
-  INTERRUPTED = 130,
-}
-
-/**
- * Possible reasons for an invalid argument.
- */
-export enum InvalidArgumentReason {
-  /**
-   * The argument value was not specified.
-   */
-  MISSING_VALUE = 0,
-
-  /**
-   * The value specified was not the correct type for the argument.
-   */
-  INCORRECT_VALUE_TYPE = 1,
-
-  /**
-   * The argument does not support multiple values.
-   */
-  ILLEGAL_MULTIPLE_VALUES = 2,
-
-  /**
-   * The value specified was not one of the defined allowable values for the argument.
-   */
-  ILLEGAL_VALUE = 3,
-
-  /**
-   * The arguments specified resulted in a sparse array of values.
-   */
-  ILLEGAL_SPARSE_ARRAY = 4,
-
-  /**
-   * The argument specified an unknown complex option property.
-   */
-  UNKNOWN_PROPERTY = 5,
-
-  /**
-   * Complex option nesting exceeds maximum of {@link MAXIMUM_COMPLEX_OPTION_NESTING_DEPTH}.
-   */
-  NESTING_DEPTH_EXCEEDED = 6,
-
-  /**
-   * Array value nesting exceeds maximum of {@link MAXIMUM_ARGUMENT_ARRAY_SIZE}.
-   */
-  ARRAY_SIZE_EXCEEDED = 7,
-
-  /**
-   * Attempt to set a primitive value on a complex object object.
-   */
-  OPTION_IS_COMPLEX = 8,
-
-  /**
-   * The value failed a custom validation function defined on the argument.
-   */
-  CUSTOM_VALIDATION = 9,
-}
-
-/**
- * Details of an invalid parsed argument.
- */
-export interface InvalidArgument {
-  /**
-   * A reason for the parsing error
-   */
-  readonly reason: InvalidArgumentReason;
-
-  /**
-   * The name of the argument specified (if it was able to be populated)
-   */
-  readonly name?: string;
-
-  /**
-   * The {@link Argument} (if it was able to be populated)
-   */
-  readonly argument?: Argument | ComplexOption;
-
-  /**
-   * The argument value (if it was able to be populated).
-   *
-   * NOTE: This value is unlikely to be valid as it is the cause of the invalid argument error.
-   */
-  readonly value?:
-    | PopulatedArgumentValues
-    | PopulatedArgumentValueType
-    | Array<PopulatedArgumentValues | PopulatedArgumentValueType>;
-
-  /**
-   * An optional message providing detail about the validation failure.
-   * Populated when {@link reason} is {@link InvalidArgumentReason.CUSTOM_VALIDATION}.
-   */
-  readonly message?: string;
-}
-
-/**
- * Result of a {@link CLI} invocation.
- */
-export default interface RunResult {
-  /**
-   * The state after processing the invocation.
-   */
-  readonly runState: RunState;
-
-  /**
-   * Populated if {@link runState} is {@link RunState.SUCCESS}, {@link RunState.PARSE_ERROR} or {@link RunState.EXECUTION_ERROR}.
-   */
-  readonly command?: Command;
-
-  /**
-   * Populated if {@link runState} is {@link RunState.PARSE_ERROR}
-   */
-  readonly invalidArguments?: ReadonlyArray<InvalidArgument>;
-
-  /**
-   * Populated if {@link runState} is {@link RunState.EXECUTION_ERROR} or {@link RunState.RUNTIME_ERROR}.
-   */
-  readonly error?: Error;
-}

package/src/api/argument/Argument.ts

@@ -1,75 +0,0 @@
-import type {
-  ArgumentSingleValueType,
-  ArgumentValues,
-  ArgumentValueType,
-  ArgumentValueTypeName,
-} from "./ArgumentValueTypes.ts";
-
-/**
- * Interface to be implemented by all {@link Command} arguments.
- */
-export default interface Argument {
-  /**
-   * Type of the argument value.
-   */
-  readonly type: ArgumentValueTypeName;
-
-  /**
-   * Optional list of values that the value must match. This is not supported for {@link ArgumentValueTypeName.BOOLEAN}.
-   */
-  readonly allowableValues?: ReadonlyArray<ArgumentSingleValueType>;
-
-  /**
-   * Optional (default is `false`) for {@link ArgumentValueTypeName.STRING} when comparing a value against {@link allowableValues}.
-   */
-  readonly isCaseInsensitive?: boolean;
-
-  /**
-   * Optional for {@link ArgumentValueTypeName.INTEGER} or {@link ArgumentValueTypeName.NUMBER} when validating a value.
-   */
-  readonly minValueInclusive?: number;
-
-  /**
-   * Optional for {@link ArgumentValueTypeName.INTEGER} or {@link ArgumentValueTypeName.NUMBER} when validating a value.
-   */
-  readonly maxValueInclusive?: number;
-
-  /**
-   * Optional configuration key to use for the argument. Must consist of alphanumeric non-whitespace uppercase
-   * ASCII or `_` characters. Must not start with a digit.
-   *
-   * If not specified a default configuration key is determined as follows: The {@link SubCommandArgument.name} is capitalized
-   * and any `-` characters are replaced with `_` characters. If the result starts with a digit, it is
-   * prefixed with `_`. Some examples:
-   *
-   * * name: `FooBar` => configuration key: `FOOBAR`
-   * * name: `Hello-World-` => configuration key: `HELLO_WORLD_`
-   * * name: `3` => configuration key: `_3`
-   *
-   * NOTE: Regardless of whether a {@link configurationKey} is specified, or the default is relied upon,
-   * it will only be used if the parent {@link Command} has specified {@link Command.enableConfiguration} as `true`.
-   */
-  readonly configurationKey?: string;
-
-  /**
-   * Optional custom validation function invoked after all built-in validation
-   * has passed. Receives the validated and type-converted value.
-   *
-   * Return `undefined` if the value is valid, or a string describing the
-   * validation error. The error string is associated with
-   * {@link InvalidArgumentReason.CUSTOM_VALIDATION}.
-   *
-   * Example: ensure array values are unique:
-   * ```typescript
-   * validate: (value) => {
-   *   const arr = value as string[];
-   *   return new Set(arr).size !== arr.length
-   *     ? "values must be unique"
-   *     : undefined;
-   * }
-   * ```
-   */
-  readonly validate?: (
-    value: ArgumentValueType | ArgumentValues | Array<ArgumentValues>,
-  ) => string | undefined;
-}

package/src/api/argument/ArgumentValueTypes.ts

@@ -1,80 +0,0 @@
-/**
- * The type of single {@link Argument} values which are supported.
- *
- * NOTE: JavaScript does not have a special runtime value for INTEGER so this is covered by `number`.
- * NOTE: `string` is also used for PASSWORD values.
- */
-export type ArgumentSingleValueType = number | string | boolean;
-
-/**
- * The type of the value to be parsed as an argument can be: `boolean`, `number` or `string` or an array of these.
- */
-export type ArgumentValueType = ArgumentSingleValueType | Array<ArgumentSingleValueType>;
-
-/**
- * A container object for populated argument values.
- *
- * The following are all valid examples:
- *
- * * `{ }`
- * * `{ foo: 1 }`
- * * `{ foo: true }`
- * * `{ foo: 'bar' }`
- * * `{ foo: [ 1, 2 ] }`
- * * `{ foo: [ true, true ] }`
- * * `{ foo: [ 'bar', 'gar' ] }`
- * * `{ foo: { a: 1 } }`
- * * `{ foo: { a: { b: 'c'} } }`
- * * `{ foo: [ { a: { b: 'c'} }, { a: { b: 'c'} } ] }`
- *
- * An array of arrays is not allowed, so the following is an INVALID example:
- *
- * * `{ foo: [ [ 1, 2 ], [3, 4 ] ] }`
- */
-export type ArgumentValues = {
-  [argName: string]: ArgumentValueType | ArgumentValues | Array<ArgumentValues>;
-};
-
-/**
- * Enum of possible {@link Argument} value types.
- */
-export enum ArgumentValueTypeName {
-  STRING = 0,
-  NUMBER = 1,
-  INTEGER = 2,
-  BOOLEAN = 3,
-  SECRET = 4,
-}
-
-/**
- * Only possible value for {@link ComplexOption.type}.
- */
-export enum ComplexValueTypeName {
-  COMPLEX = 5,
-}
-
-/**
- * Populated single value type is very similar to {@link ArgumentSingleValueType} but allows for an illegal
- * undefined value.
- */
-export type PopulatedArgumentSingleValueType = ArgumentSingleValueType | undefined;
-
-/**
- * Populated argument value types are very similar to {@link ArgumentValueType} but allow for illegal
- * undefined values.
- */
-export type PopulatedArgumentValueType =
-  | PopulatedArgumentSingleValueType
-  | Array<PopulatedArgumentSingleValueType>;
-
-/**
- * Populated values are very similar to {@link ArgumentValues} but allow for illegal
- * undefined properties and array entries.
- */
-export interface PopulatedArgumentValues {
-  [argName: string]:
-    | PopulatedArgumentValueType
-    | PopulatedArgumentValues
-    | Array<PopulatedArgumentValues | undefined>
-    | undefined;
-}

package/src/api/argument/ComplexOption.ts

@@ -1,27 +0,0 @@
-import type Option from "./Option.ts";
-import type { ArgumentValues, ComplexValueTypeName } from "./ArgumentValueTypes.ts";
-
-export const MAXIMUM_COMPLEX_OPTION_NESTING_DEPTH = 10;
-
-/**
- * A container option argument for defining {@link SubCommand} nested argument hierarchies.
- */
-export default interface ComplexOption extends Omit<
-  Option,
-  "type" | "defaultValue" | "allowableValues"
-> {
-  /**
-   * Type of the argument value.
-   */
-  readonly type: ComplexValueTypeName;
-
-  /**
-   * List of child {@link Option} properties.
-   */
-  readonly properties: ReadonlyArray<Option | ComplexOption>;
-
-  /**
-   * Default value for the argument if not specified.
-   */
-  readonly defaultValue?: ArgumentValues | Array<ArgumentValues>;
-}

package/src/api/argument/GlobalCommandArgument.ts

@@ -1,17 +0,0 @@
-import type Argument from "./Argument.ts";
-import type { ArgumentSingleValueType } from "./ArgumentValueTypes.ts";
-
-/**
- * Interface to be implemented by a single {@link Argument} defined by a {@link GlobalCommand}.
- */
-export default interface GlobalCommandArgument extends Argument {
-  /**
-   * Default value for the argument if not specified.
-   */
-  readonly defaultValue?: ArgumentSingleValueType;
-
-  /**
-   * If this is `true` the argument does not need to be specified nor have a default value. The default is `false`.
-   */
-  readonly isOptional?: boolean;
-}