@cli-forge/parser 0.10.1 → 0.12.0

package/dist/lib/utils/chain.d.ts

@@ -0,0 +1,331 @@
+import { UnknownOptionConfig } from '../option-types';
+import { ArgvParser, ParsedArgs } from '../parser';
+type UnaryFunction<T, R> = (arg: T) => R;
+/**
+ * Applies a series of functions to an initial value, passing the result of each function to the next.
+ *
+ * Used to convert code that looks like:
+ * ```typescript
+ * const a = addB(addC({ a: 'a' }));
+ * ```
+ * to:
+ * ```typescript
+ * const a = chain({ a: 'a' }, addB, addC);
+ * ```
+ *
+ * See [composable-options](/examples/composable-options) for an example of how this can be used.
+ *
+ * @param initial Initial value to pass through the chain
+ * @param fns Functions to apply to the initial value, and each subsequent value
+ * @returns Updated value after all functions have been applied
+ * @hidden docs for {@link chain} are found on the main signature.
+ */
+export declare function chain<T0, R>(initial: T0, fn0: UnaryFunction<T0, R>): R;
+/**
+ * Applies a series of functions to an initial value, passing the result of each function to the next.
+ *
+ * Used to convert code that looks like:
+ * ```typescript
+ * const a = addB(addC({ a: 'a' }));
+ * ```
+ * to:
+ * ```typescript
+ * const a = chain({ a: 'a' }, addB, addC);
+ * ```
+ *
+ * See [composable-options](/examples/composable-options) for an example of how this can be used.
+ *
+ * @param initial Initial value to pass through the chain
+ * @param fns Functions to apply to the initial value, and each subsequent value
+ * @returns Updated value after all functions have been applied
+ * @hidden docs for {@link chain} are found on the main signature.
+ */
+export declare function chain<T0, T1, R>(initial: T0, fn0: UnaryFunction<T0, T1>, fn1: UnaryFunction<T1, R>): R;
+/**
+ * Applies a series of functions to an initial value, passing the result of each function to the next.
+ *
+ * Used to convert code that looks like:
+ * ```typescript
+ * const a = addB(addC({ a: 'a' }));
+ * ```
+ * to:
+ * ```typescript
+ * const a = chain({ a: 'a' }, addB, addC);
+ * ```
+ *
+ * See [composable-options](/examples/composable-options) for an example of how this can be used.
+ *
+ * @param initial Initial value to pass through the chain
+ * @param fns Functions to apply to the initial value, and each subsequent value
+ * @returns Updated value after all functions have been applied
+ * @hidden docs for {@link chain} are found on the main signature.
+ */
+export declare function chain<T0, T1, T2, R>(initial: T0, fn0: UnaryFunction<T0, T1>, fn1: UnaryFunction<T1, T2>, fn2: UnaryFunction<T2, R>): R;
+/**
+ * Applies a series of functions to an initial value, passing the result of each function to the next.
+ *
+ * Used to convert code that looks like:
+ * ```typescript
+ * const a = addB(addC({ a: 'a' }));
+ * ```
+ * to:
+ * ```typescript
+ * const a = chain({ a: 'a' }, addB, addC);
+ * ```
+ *
+ * See [composable-options](/examples/composable-options) for an example of how this can be used.
+ *
+ * @param initial Initial value to pass through the chain
+ * @param fns Functions to apply to the initial value, and each subsequent value
+ * @returns Updated value after all functions have been applied
+ * @hidden docs for {@link chain} are found on the main signature.
+ */
+export declare function chain<T0, T1, T2, T3, R>(initial: T0, fn0: UnaryFunction<T0, T1>, fn1: UnaryFunction<T1, T2>, fn2: UnaryFunction<T2, T3>, fn3: UnaryFunction<T3, R>): R;
+/**
+ * Applies a series of functions to an initial value, passing the result of each function to the next.
+ *
+ * Used to convert code that looks like:
+ * ```typescript
+ * const a = addB(addC({ a: 'a' }));
+ * ```
+ * to:
+ * ```typescript
+ * const a = chain({ a: 'a' }, addB, addC);
+ * ```
+ *
+ * See [composable-options](/examples/composable-options) for an example of how this can be used.
+ *
+ * @param initial Initial value to pass through the chain
+ * @param fns Functions to apply to the initial value, and each subsequent value
+ * @returns Updated value after all functions have been applied
+ * @hidden docs for {@link chain} are found on the main signature.
+ */
+export declare function chain<T0, T1, T2, T3, T4, R>(initial: T0, fn0: UnaryFunction<T0, T1>, fn1: UnaryFunction<T1, T2>, fn2: UnaryFunction<T2, T3>, fn3: UnaryFunction<T3, T4>, fn4: UnaryFunction<T4, R>): R;
+/**
+ * Applies a series of functions to an initial value, passing the result of each function to the next.
+ *
+ * Used to convert code that looks like:
+ * ```typescript
+ * const a = addB(addC({ a: 'a' }));
+ * ```
+ * to:
+ * ```typescript
+ * const a = chain({ a: 'a' }, addB, addC);
+ * ```
+ *
+ * See [composable-options](/examples/composable-options) for an example of how this can be used.
+ *
+ * @param initial Initial value to pass through the chain
+ * @param fns Functions to apply to the initial value, and each subsequent value
+ * @returns Updated value after all functions have been applied
+ * @hidden docs for {@link chain} are found on the main signature.
+ */
+export declare function chain<T0, T1, T2, T3, T4, T5, R>(initial: T0, fn0: UnaryFunction<T0, T1>, fn1: UnaryFunction<T1, T2>, fn2: UnaryFunction<T2, T3>, fn3: UnaryFunction<T3, T4>, fn4: UnaryFunction<T4, T5>, fn5: UnaryFunction<T5, R>): R;
+/**
+ * Applies a series of functions to an initial value, passing the result of each function to the next.
+ *
+ * Used to convert code that looks like:
+ * ```typescript
+ * const a = addB(addC({ a: 'a' }));
+ * ```
+ * to:
+ * ```typescript
+ * const a = chain({ a: 'a' }, addB, addC);
+ * ```
+ *
+ * See [composable-options](/examples/composable-options) for an example of how this can be used.
+ *
+ * @param initial Initial value to pass through the chain
+ * @param fns Functions to apply to the initial value, and each subsequent value
+ * @returns Updated value after all functions have been applied
+ * @hidden docs for {@link chain} are found on the main signature.
+ */
+export declare function chain<T0, T1, T2, T3, T4, T5, T6, R>(initial: T0, fn0: UnaryFunction<T0, T1>, fn1: UnaryFunction<T1, T2>, fn2: UnaryFunction<T2, T3>, fn3: UnaryFunction<T3, T4>, fn4: UnaryFunction<T4, T5>, fn5: UnaryFunction<T5, T6>, fn6: UnaryFunction<T6, R>): R;
+/**
+ * Applies a series of functions to an initial value, passing the result of each function to the next.
+ *
+ * Used to convert code that looks like:
+ * ```typescript
+ * const a = addB(addC({ a: 'a' }));
+ * ```
+ * to:
+ * ```typescript
+ * const a = chain({ a: 'a' }, addB, addC);
+ * ```
+ *
+ * See [composable-options](/examples/composable-options) for an example of how this can be used.
+ *
+ * @param initial Initial value to pass through the chain
+ * @param fns Functions to apply to the initial value, and each subsequent value
+ * @returns Updated value after all functions have been applied
+ * @hidden docs for {@link chain} are found on the main signature.
+ */
+export declare function chain<T0, T1, T2, T3, T4, T5, T6, T7, R>(initial: T0, fn0: UnaryFunction<T0, T1>, fn1: UnaryFunction<T1, T2>, fn2: UnaryFunction<T2, T3>, fn3: UnaryFunction<T3, T4>, fn4: UnaryFunction<T4, T5>, fn5: UnaryFunction<T5, T6>, fn6: UnaryFunction<T6, T7>, fn7: UnaryFunction<T7, R>): R;
+/**
+ * Applies a series of functions to an initial value, passing the result of each function to the next.
+ *
+ * Used to convert code that looks like:
+ * ```typescript
+ * const a = addB(addC({ a: 'a' }));
+ * ```
+ * to:
+ * ```typescript
+ * const a = chain({ a: 'a' }, addB, addC);
+ * ```
+ *
+ * See [composable-options](/examples/composable-options) for an example of how this can be used.
+ *
+ * @param initial Initial value to pass through the chain
+ * @param fns Functions to apply to the initial value, and each subsequent value
+ * @returns Updated value after all functions have been applied
+ * @hidden docs for {@link chain} are found on the main signature.
+ */
+export declare function chain<T0, T1, T2, T3, T4, T5, T6, T7, T8, R>(initial: T0, fn0: UnaryFunction<T0, T1>, fn1: UnaryFunction<T1, T2>, fn2: UnaryFunction<T2, T3>, fn3: UnaryFunction<T3, T4>, fn4: UnaryFunction<T4, T5>, fn5: UnaryFunction<T5, T6>, fn6: UnaryFunction<T6, T7>, fn7: UnaryFunction<T7, T8>, fn8: UnaryFunction<T8, R>): R;
+/**
+ * Applies a series of functions to an initial value, passing the result of each function to the next.
+ *
+ * Used to convert code that looks like:
+ * ```typescript
+ * const a = addB(addC({ a: 'a' }));
+ * ```
+ * to:
+ * ```typescript
+ * const a = chain({ a: 'a' }, addB, addC);
+ * ```
+ *
+ * See [composable-options](/examples/composable-options) for an example of how this can be used.
+ *
+ * @param initial Initial value to pass through the chain
+ * @param fns Functions to apply to the initial value, and each subsequent value
+ * @returns Updated value after all functions have been applied
+ * @hidden docs for {@link chain} are found on the main signature.
+ */
+export declare function chain<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, R>(initial: T0, fn0: UnaryFunction<T0, T1>, fn1: UnaryFunction<T1, T2>, fn2: UnaryFunction<T2, T3>, fn3: UnaryFunction<T3, T4>, fn4: UnaryFunction<T4, T5>, fn5: UnaryFunction<T5, T6>, fn6: UnaryFunction<T6, T7>, fn7: UnaryFunction<T7, T8>, fn8: UnaryFunction<T8, T9>, fn9: UnaryFunction<T9, R>): R;
+/**
+ * Applies a series of functions to an initial value, passing the result of each function to the next.
+ *
+ * Used to convert code that looks like:
+ * ```typescript
+ * const a = addB(addC({ a: 'a' }));
+ * ```
+ * to:
+ * ```typescript
+ * const a = chain({ a: 'a' }, addB, addC);
+ * ```
+ *
+ * See [composable-options](/examples/composable-options) for an example of how this can be used.
+ *
+ * @param initial Initial value to pass through the chain
+ * @param fns Functions to apply to the initial value, and each subsequent value
+ * @returns Updated value after all functions have been applied
+ * @hidden docs for {@link chain} are found on the main signature.
+ */
+export declare function chain<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, R>(initial: T0, fn0: UnaryFunction<T0, T1>, fn1: UnaryFunction<T1, T2>, fn2: UnaryFunction<T2, T3>, fn3: UnaryFunction<T3, T4>, fn4: UnaryFunction<T4, T5>, fn5: UnaryFunction<T5, T6>, fn6: UnaryFunction<T6, T7>, fn7: UnaryFunction<T7, T8>, fn8: UnaryFunction<T8, T9>, fn9: UnaryFunction<T9, T10>, fn10: UnaryFunction<T10, R>): R;
+/**
+ * Applies a series of functions to an initial value, passing the result of each function to the next.
+ *
+ * Used to convert code that looks like:
+ * ```typescript
+ * const a = addB(addC({ a: 'a' }));
+ * ```
+ * to:
+ * ```typescript
+ * const a = chain({ a: 'a' }, addB, addC);
+ * ```
+ *
+ * See [composable-options](/examples/composable-options) for an example of how this can be used.
+ *
+ * @param initial Initial value to pass through the chain
+ * @param fns Functions to apply to the initial value, and each subsequent value
+ * @returns Updated value after all functions have been applied
+ * @hidden docs for {@link chain} are found on the main signature.
+ */
+export declare function chain<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, R>(initial: T0, fn0: UnaryFunction<T0, T1>, fn1: UnaryFunction<T1, T2>, fn2: UnaryFunction<T2, T3>, fn3: UnaryFunction<T3, T4>, fn4: UnaryFunction<T4, T5>, fn5: UnaryFunction<T5, T6>, fn6: UnaryFunction<T6, T7>, fn7: UnaryFunction<T7, T8>, fn8: UnaryFunction<T8, T9>, fn9: UnaryFunction<T9, T10>, fn10: UnaryFunction<T10, T11>, fn11: UnaryFunction<T11, R>): R;
+/**
+ * Applies a series of functions to an initial value, passing the result of each function to the next.
+ *
+ * Used to convert code that looks like:
+ * ```typescript
+ * const a = addB(addC({ a: 'a' }));
+ * ```
+ * to:
+ * ```typescript
+ * const a = chain({ a: 'a' }, addB, addC);
+ * ```
+ *
+ * See [composable-options](/examples/composable-options) for an example of how this can be used.
+ *
+ * @param initial Initial value to pass through the chain
+ * @param fns Functions to apply to the initial value, and each subsequent value
+ * @returns Updated value after all functions have been applied
+ * @hidden docs for {@link chain} are found on the main signature.
+ */
+export declare function chain<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, R>(initial: T0, fn0: UnaryFunction<T0, T1>, fn1: UnaryFunction<T1, T2>, fn2: UnaryFunction<T2, T3>, fn3: UnaryFunction<T3, T4>, fn4: UnaryFunction<T4, T5>, fn5: UnaryFunction<T5, T6>, fn6: UnaryFunction<T6, T7>, fn7: UnaryFunction<T7, T8>, fn8: UnaryFunction<T8, T9>, fn9: UnaryFunction<T9, T10>, fn10: UnaryFunction<T10, T11>, fn11: UnaryFunction<T11, T12>, fn12: UnaryFunction<T12, R>): R;
+/**
+ * Applies a series of functions to an initial value, passing the result of each function to the next.
+ *
+ * Used to convert code that looks like:
+ * ```typescript
+ * const a = addB(addC({ a: 'a' }));
+ * ```
+ * to:
+ * ```typescript
+ * const a = chain({ a: 'a' }, addB, addC);
+ * ```
+ *
+ * See [composable-options](/examples/composable-options) for an example of how this can be used.
+ *
+ * @param initial Initial value to pass through the chain
+ * @param fns Functions to apply to the initial value, and each subsequent value
+ * @returns Updated value after all functions have been applied
+ * @hidden docs for {@link chain} are found on the main signature.
+ */
+export declare function chain<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, R>(initial: T0, fn0: UnaryFunction<T0, T1>, fn1: UnaryFunction<T1, T2>, fn2: UnaryFunction<T2, T3>, fn3: UnaryFunction<T3, T4>, fn4: UnaryFunction<T4, T5>, fn5: UnaryFunction<T5, T6>, fn6: UnaryFunction<T6, T7>, fn7: UnaryFunction<T7, T8>, fn8: UnaryFunction<T8, T9>, fn9: UnaryFunction<T9, T10>, fn10: UnaryFunction<T10, T11>, fn11: UnaryFunction<T11, T12>, fn12: UnaryFunction<T12, T13>, fn13: UnaryFunction<T13, R>): R;
+/**
+ * Applies a series of functions to an initial value, passing the result of each function to the next.
+ *
+ * Used to convert code that looks like:
+ * ```typescript
+ * const a = addB(addC({ a: 'a' }));
+ * ```
+ * to:
+ * ```typescript
+ * const a = chain({ a: 'a' }, addB, addC);
+ * ```
+ *
+ * See [composable-options](/examples/composable-options) for an example of how this can be used.
+ *
+ * @param initial Initial value to pass through the chain
+ * @param fns Functions to apply to the initial value, and each subsequent value
+ * @returns Updated value after all functions have been applied
+ * @hidden docs for {@link chain} are found on the main signature.
+ */
+export declare function chain<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, R>(initial: T0, fn0: UnaryFunction<T0, T1>, fn1: UnaryFunction<T1, T2>, fn2: UnaryFunction<T2, T3>, fn3: UnaryFunction<T3, T4>, fn4: UnaryFunction<T4, T5>, fn5: UnaryFunction<T5, T6>, fn6: UnaryFunction<T6, T7>, fn7: UnaryFunction<T7, T8>, fn8: UnaryFunction<T8, T9>, fn9: UnaryFunction<T9, T10>, fn10: UnaryFunction<T10, T11>, fn11: UnaryFunction<T11, T12>, fn12: UnaryFunction<T12, T13>, fn13: UnaryFunction<T13, T14>, fn14: UnaryFunction<T14, R>): R;
+/**
+ * Applies a series of functions to an initial value, passing the result of each function to the next.
+ *
+ * Used to convert code that looks like:
+ * ```typescript
+ * const a = addB(addC({ a: 'a' }));
+ * ```
+ * to:
+ * ```typescript
+ * const a = chain({ a: 'a' }, addB, addC);
+ * ```
+ *
+ * See [composable-options](/examples/composable-options) for an example of how this can be used.
+ *
+ * @param {T0} initial Initial value to pass through the chain
+ * @param fns Functions to apply to the initial value, and each subsequent value
+ * @returns {R} Updated value after all functions have been applied
+ */
+export declare function chain<T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, R>(initial: T0, fn0: UnaryFunction<T0, T1>, fn1: UnaryFunction<T1, T2>, fn2: UnaryFunction<T2, T3>, fn3: UnaryFunction<T3, T4>, fn4: UnaryFunction<T4, T5>, fn5: UnaryFunction<T5, T6>, fn6: UnaryFunction<T6, T7>, fn7: UnaryFunction<T7, T8>, fn8: UnaryFunction<T8, T9>, fn9: UnaryFunction<T9, T10>, fn10: UnaryFunction<T10, T11>, fn11: UnaryFunction<T11, T12>, fn12: UnaryFunction<T12, T13>, fn13: UnaryFunction<T13, T14>, fn14: UnaryFunction<T14, T15>, fn15: UnaryFunction<T15, R>): R;
+/**
+ * A composition helper to be used with {@link chain}.
+ *
+ * @param name The name of the option to add
+ * @param config The configuration for the option
+ * @returns A unary function that adds an option to an {@link ArgvParser}.
+ */
+export declare function makeComposableOption<const TKey extends string, const TOptionConfig extends UnknownOptionConfig>(name: TKey, config: TOptionConfig): <const T extends ParsedArgs>(argv: ArgvParser<T>) => ArgvParser<T & ({ [key in TKey]: import("../option-types").WithOptional<import("../option-types").ResolveOptionType<TOptionConfig>, TOptionConfig>; } extends infer T_1 ? { [K in keyof T_1 as undefined extends { [key in TKey]: import("../option-types").WithOptional<import("../option-types").ResolveOptionType<TOptionConfig>, TOptionConfig>; }[K] ? K : never]?: T_1[K] | undefined; } : never) & ({ [key in TKey]: import("../option-types").WithOptional<import("../option-types").ResolveOptionType<TOptionConfig>, TOptionConfig>; } extends infer T_2 ? { [K_1 in keyof T_2 as undefined extends { [key in TKey]: import("../option-types").WithOptional<import("../option-types").ResolveOptionType<TOptionConfig>, TOptionConfig>; }[K_1] ? never : K_1]: T_2[K_1]; } : never)>;
+export {};

package/dist/lib/utils/chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../../../src/lib/utils/chain.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,wFAAwF;AACxF,4FAA4F;AAC5F,0GAA0G;AAC1G,oGAAoG;AACpG,+CAA+C;;AA4kB/C,sBAKC;AASD,oDAMC;AAlDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,SAAgB,KAAK,CACnB,OAAW,EACX,GAAG,GAA8B;IAEjC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,oBAAoB,CAGlC,IAAU,EAAE,MAAqB;IACjC,OAAO,CAA6B,IAAmB,EAAE,EAAE,CACzD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/lib/utils/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../../src/lib/utils/flags.ts"],"names":[],"mappings":";;AAEA,wBAEC;AACD,kCAaC;AACD,gCAEC;AArBD,iEAA+D;AAE/D,SAAgB,MAAM,CAAC,GAAW;IAChC,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AACD,SAAgB,WAAW,CAAC,GAAiB;IAC3C,0BAA0B;IAC1B,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,IAAA,4CAAqB,EAAC,GAAG,CAAC,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACtB,sCAAsC;IACxC,CAAC;SAAM,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;AACzC,CAAC;AACD,SAAgB,UAAU,CAAC,GAAW;IACpC,OAAO,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACrD,CAAC"}

package/dist/lib/utils/get-configured-key.d.ts

@@ -0,0 +1,3 @@
+import { UnknownOptionConfig } from '../option-types';
+import { ParsedArgs } from '../parser';
+export declare function getConfiguredOptionKey<T extends ParsedArgs>(key: string, configuredOptions: Partial<Record<keyof T, UnknownOptionConfig>>): keyof T | undefined;

package/dist/lib/utils/get-configured-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-configured-key.js","sourceRoot":"","sources":["../../../src/lib/utils/get-configured-key.ts"],"names":[],"mappings":";;AAGA,wDA+CC;AA/CD,SAAgB,sBAAsB,CACpC,GAAW,EACX,iBAAgE;IAEhE,IAAI,GAAG,IAAI,iBAAiB,EAAE,CAAC;QAC7B,OAAO,GAAc,CAAC;IACxB,CAAC;IAED,SAAS,0BAA0B,CAAC,GAAW;QAC7C,IACE,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;YACpB,GAAG,CAAC,MAAM,GAAG,CAAC;YACd,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAC/B,CAAC;YACD,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC9B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,SAAS,wBAAwB,CAAC,GAAW;QAC3C,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,wCAAwC;IACxC,MAAM,aAAa,GAAG,wBAAwB,CAC5C,0BAA0B,CAAC,GAAG,CAAC,CAChC,CAAC;IAEF,IAAI,aAAa,IAAI,iBAAiB,EAAE,CAAC;QACvC,OAAO,aAAwB,CAAC;IAClC,CAAC;IAED,KAAK,MAAM,aAAa,IAAI,iBAAiB,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;QAChD,IAAI,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO,aAAwB,CAAC;QAClC,CAAC;QACD,4CAA4C;QAC5C,IAAI,MAAM,EAAE,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACxE,OAAO,aAAwB,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/lib/utils/read-default-value.d.ts

@@ -0,0 +1,2 @@
+import { UnknownOptionConfig, OptionConfigToType } from '../option-types';
+export declare function readDefaultValue<const T extends UnknownOptionConfig>(option: T): [OptionConfigToType<T> | undefined, string | undefined];

package/{src → dist}/lib/utils/read-default-value.js

@@ -13,6 +13,8 @@ function readDefaultValue(option) {
                 const factory = declaredDefault.factory;
                 return [factory(), declaredDefault.description];
             }
+            // Plain object default (e.g., for object options with default: { foo: 'bar' })
+            return [declaredDefault, undefined];
         }
         else {
             return [declaredDefault, undefined];

package/dist/lib/utils/read-default-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-default-value.js","sourceRoot":"","sources":["../../../src/lib/utils/read-default-value.ts"],"names":[],"mappings":";;AAOA,4CAsBC;AAtBD,SAAgB,gBAAgB,CAC9B,MAAS;IAET,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,eAAe,GAAG,MAAM,CAAC,OAA4B,CAAC;QAC5D,IAAI,OAAO,eAAe,KAAK,QAAQ,EAAE,CAAC;YACxC,IAAI,OAAO,IAAI,eAAe,EAAE,CAAC;gBAC/B,MAAM,KAAK,GAAG,eAAe,CAAC,KAAqC,CAAC;gBACpE,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC;YAC9C,CAAC;YACD,IAAI,SAAS,IAAI,eAAe,EAAE,CAAC;gBACjC,MAAM,OAAO,GACX,eAAe,CAAC,OAA6C,CAAC;gBAChE,OAAO,CAAC,OAAO,EAAE,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC;YAClD,CAAC;YACD,+EAA+E;YAC/E,OAAO,CAAC,eAA+C,EAAE,SAAS,CAAC,CAAC;QACtE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IACD,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAChC,CAAC"}

package/package.json

@@ -1,20 +1,32 @@
 {
   "name": "@cli-forge/parser",
-  "version": "0.10.1",
+  "version": "0.12.0",
   "dependencies": {
     "tslib": "^2.3.0"
   },
   "type": "commonjs",
-  "main": "./src/index.js",
-  "typings": "./src/index.d.ts",
+  "main": "./dist/index.js",
+  "typings": "./dist/index.d.ts",
   "license": "ISC",
+  "homepage": "https://craigory.dev/cli-forge/",
   "repository": {
     "type": "git",
     "directory": "packages/parser",
     "url": "https://github.com/AgentEnder/cli-forge"
   },
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/**/*",
+    "**/*.md"
+  ],
   "publishConfig": {
     "access": "public"
-  },
-  "types": "./src/index.d.ts"
-}
+  }
+}

package/src/lib/config-files/README.md

@@ -0,0 +1,10 @@
+Intentions / Goals of configuration loader system:
+
+- Easily implement the following configuration consumers:
+  - Load configuration from static js / ts / json files
+  - Load configuration from package.json
+  - Load configuration via a custom function
+- Regardless of how configuration is loaded, our return type should be the same
+- Allow for `extends` functionality, where one configuration file can extend another
+
+As much of this as possible should be abstracted away from the configuration loader itself, to make it easier to implement new configuration loaders in the future.

package/src/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/parser/src/index.ts"],"names":[],"mappings":";;;;AAAA,uDAA6B;AAC7B,2EAAiD;AACjD,wDAA8B;AAC9B,6DAAmC;AACnC,yEAA+C;AAC/C,4DAAkC;AAElC;;GAEG;AACH,iFAAyD"}

package/src/lib/config-files/configuration-loader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"configuration-loader.js","sourceRoot":"","sources":["../../../../../../packages/parser/src/lib/config-files/configuration-loader.ts"],"names":[],"mappings":";;AAwBA,oDAgCC;AAxDD,+BAA4B;AAsB5B,iFAAiF;AACjF,yEAAyE;AACzE,SAAgB,oBAAoB,CAClC,iBAAyB,EACzB,OAAmC;IAEnC,SAAS,iBAAiB,CACxB,QAAgB,EAChB,QAAkC;QAElC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,QAAQ,GAAG,oBAAoB,CACnC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;gBAC5B,CAAC,CAAC,IAAA,WAAI,EAAC,iBAAiB,EAAE,MAAM,CAAC,OAAO,CAAC;gBACzC,CAAC,CAAC,MAAM,CAAC,OAAO,EAClB,OAAO,CACR,CAAC;YACF,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;QACpC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,QAAQ,GAAM,EAAO,CAAC;IAC1B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACnD,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,GAAG;gBACT,GAAG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACtC,GAAG,QAAQ;aACZ,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/src/lib/config-files/index.d.ts

@@ -1,3 +0,0 @@
-export * from './configuration-loader';
-export * from './json-file-loader';
-export * from './package-json-loader';

package/src/lib/config-files/index.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./configuration-loader"), exports);
-tslib_1.__exportStar(require("./json-file-loader"), exports);
-tslib_1.__exportStar(require("./package-json-loader"), exports);
-//# sourceMappingURL=index.js.map

package/src/lib/config-files/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/parser/src/lib/config-files/index.ts"],"names":[],"mappings":";;;AAAA,iEAAuC;AACvC,6DAAmC;AACnC,gEAAsC"}

package/src/lib/config-files/json-file-loader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"json-file-loader.js","sourceRoot":"","sources":["../../../../../../packages/parser/src/lib/config-files/json-file-loader.ts"],"names":[],"mappings":";;AAYA,0DAuCC;AAnDD,2BAAkC;AAClC,+BAA+B;AAG/B,mCAA0C;AAE1C;;;;;GAKG;AACH,SAAgB,uBAAuB,CACrC,QAAgB,EAChB,SAA4B;IAE5B,SAAS,YAAY,CAAC,QAAgB;QACpC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,oBAAoB;QAChB,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAEjC,OAAO,CAAC,iBAAyB;YAC/B,MAAM,WAAW,GAAG,IAAA,uBAAe,EAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;YACjE,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnD,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CACb,sDAAsD,WAAW,sHAAsH,CACxL,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAC3B,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,IAAI,CAAC,QAAgB;YACnB,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YACpC,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,CAAC,cAAO,CAAC,MAAM,CAAC;YACd,OAAO,wBAAwB,GAAG,QAAQ,CAAC;QAC7C,CAAC;KACF;IAED,OAAO,IAAI,oBAAoB,EAAE,CAAC;AACpC,CAAC"}

package/src/lib/config-files/package-json-loader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"package-json-loader.js","sourceRoot":"","sources":["../../../../../../packages/parser/src/lib/config-files/package-json-loader.ts"],"names":[],"mappings":";;AAUA,8EAUC;AApBD,yCAAoC;AAGpC,yDAA6D;AAE7D;;;;GAIG;AACH,SAAgB,iCAAiC,CAC/C,GAAW;IAEX,MAAM,MAAM,GAAG,IAAA,0CAAuB,EACpC,cAAc,EACd,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CACpB,CAAC;IACD,MAAc,CAAC,mBAAO,CAAC,MAAM,CAAC,GAAG,GAAG,EAAE,CACrC,kCAAkC,GAAG,GAAG,CAAC;IAC3C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/src/lib/config-files/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../../packages/parser/src/lib/config-files/utils.ts"],"names":[],"mappings":";;AAGA,0CAiBC;AApBD,qCAAqC;AACrC,yCAA0C;AAE1C,SAAgB,eAAe,CAC7B,cAAsB,EACtB,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE;IAEzB,4CAA4C;IAC5C,IAAI,IAAwB,CAAC;IAC7B,IAAI,OAAO,GAAG,SAAS,CAAC;IACxB,OAAO,IAAI,KAAK,OAAO,EAAE,CAAC;QACxB,IAAI,GAAG,OAAO,CAAC;QACf,MAAM,QAAQ,GAAG,IAAA,gBAAI,EAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC/C,IAAI,IAAA,oBAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,OAAO,QAAQ,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,IAAA,mBAAO,EAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/src/lib/helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../../packages/parser/src/lib/helpers.ts"],"names":[],"mappings":";AAAA,iFAAiF;;AAwBjF,0BAEC;AAED,wBAEC;AA5BD,SAAS,sBAAsB;IAC7B,0DAA0D;IAC1D,qDAAqD;IACrD,IAAI,oBAAoB,EAAE;QAAE,OAAO,CAAC,CAAC;IACrC,mCAAmC;IACnC,0DAA0D;IAC1D,kEAAkE;IAClE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,oBAAoB;IAC3B,0FAA0F;IAC1F,oGAAoG;IACpG,OAAO,aAAa,EAAE,IAAI,CAAE,OAA2B,CAAC,UAAU,CAAC;AACrE,CAAC;AAED,SAAS,aAAa;IACpB,oEAAoE;IACpE,0GAA0G;IAC1G,OAAO,CAAC,CAAE,OAA2B,CAAC,QAAQ,CAAC,QAAQ,CAAC;AAC1D,CAAC;AAED,SAAgB,OAAO,CAAC,IAAc;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,SAAgB,MAAM,CAAC,IAAc;IACnC,OAAO,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;AACxC,CAAC"}

package/src/lib/option-types/array.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"array.js","sourceRoot":"","sources":["../../../../../../packages/parser/src/lib/option-types/array.ts"],"names":[],"mappings":""}

package/src/lib/option-types/boolean.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"boolean.js","sourceRoot":"","sources":["../../../../../../packages/parser/src/lib/option-types/boolean.ts"],"names":[],"mappings":""}

package/src/lib/option-types/common.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../../../../packages/parser/src/lib/option-types/common.ts"],"names":[],"mappings":""}

package/src/lib/option-types/index.d.ts

@@ -1,14 +0,0 @@
-import { OptionConfig } from './option-config';
-export * from './option-config-to-type';
-export * from './common';
-export * from './array';
-export * from './boolean';
-export * from './number';
-export * from './object';
-export * from './string';
-export { OptionConfig };
-export type Internal<T extends OptionConfig> = T & InternalOptionConfig;
-export type InternalOptionConfig = OptionConfig & {
-    key: string;
-    position?: number;
-};

package/src/lib/option-types/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/parser/src/lib/option-types/index.ts"],"names":[],"mappings":";;;AAEA,kEAAwC;AACxC,mDAAyB;AACzB,kDAAwB;AACxB,oDAA0B;AAC1B,mDAAyB;AACzB,mDAAyB;AACzB,mDAAyB"}

package/src/lib/option-types/number.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"number.js","sourceRoot":"","sources":["../../../../../../packages/parser/src/lib/option-types/number.ts"],"names":[],"mappings":""}

package/src/lib/option-types/object.d.ts

@@ -1,10 +0,0 @@
-import { CommonOptionConfig } from './common';
-import { OptionConfig } from './option-config';
-export interface ObjectOptionConfig<TCoerce = Record<string, string>, TProperties extends {
-    [key: string]: Readonly<OptionConfig>;
-} = Record<string, any>> extends Omit<CommonOptionConfig<Record<string, string>, TCoerce>, 'choices'> {
-    type: 'object';
-    /** */
-    properties: TProperties;
-    additionalProperties?: false | 'string' | 'number' | 'boolean';
-}

package/src/lib/option-types/object.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../../../../packages/parser/src/lib/option-types/object.ts"],"names":[],"mappings":""}

package/src/lib/option-types/option-config-to-type.d.ts

@@ -1,26 +0,0 @@
-import { OptionConfig } from './option-config';
-import { ArrayOptionConfig } from './array';
-import { ObjectOptionConfig } from './object';
-/**
- * Converts an OptionConfig to the TypeScript type for the parsed value.
- */
-export type OptionConfigToType<TOptionConfig extends OptionConfig> = UndefinedIfRequiredAndNoDefault<TOptionConfig, InferTChoice<TOptionConfig> extends [never] ? TOptionConfig['coerce'] extends (s: any) => any ? ReturnType<TOptionConfig['coerce']> : {
-    string: string;
-    number: number;
-    boolean: boolean;
-    array: ArrayItems<TOptionConfig>[];
-    object: TOptionConfig extends ObjectOptionConfig ? ResolveTProperties<TOptionConfig['properties']> & AdditionalProperties<TOptionConfig> : never;
-}[TOptionConfig['type']] : InferTChoice<TOptionConfig>>;
-export type UndefinedIfRequiredAndNoDefault<TOptionConfig extends OptionConfig, ResolvedValue> = TOptionConfig extends {
-    required: true;
-} ? ResolvedValue : TOptionConfig extends {
-    default: unknown;
-} ? ResolvedValue : // Option is not required and has no default value
-ResolvedValue | undefined;
-type ArrayItems<TOptionConfig extends OptionConfig> = TOptionConfig extends ArrayOptionConfig<string | number> ? TOptionConfig['items'] extends 'string' ? string : number : never;
-type AdditionalProperties<TOptionConfig extends ObjectOptionConfig> = TOptionConfig['additionalProperties'] extends 'string' ? Record<string, string> : TOptionConfig['additionalProperties'] extends 'number' ? Record<string, number> : TOptionConfig['additionalProperties'] extends 'boolean' ? Record<string, boolean> : Record<string, never>;
-type ResolveTProperties<TProperties extends Record<string, OptionConfig>> = {
-    [key in keyof TProperties]: OptionConfigToType<TProperties[key]>;
-};
-type InferTChoice<TOptionConfig> = 'choices' extends keyof TOptionConfig ? TOptionConfig['choices'] extends Array<infer TChoice> ? TChoice : TOptionConfig['choices'] extends () => Array<infer TChoice> ? TChoice : never : never;
-export {};

package/src/lib/option-types/option-config-to-type.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"option-config-to-type.js","sourceRoot":"","sources":["../../../../../../packages/parser/src/lib/option-types/option-config-to-type.ts"],"names":[],"mappings":""}

package/src/lib/option-types/option-config.d.ts

@@ -1,15 +0,0 @@
-import { ArrayOptionConfig } from './array';
-import { BooleanOptionConfig } from './boolean';
-import { NumberOptionConfig } from './number';
-import { ObjectOptionConfig } from './object';
-import { StringOptionConfig } from './string';
-/**
- * Configures an option for the parser. See subtypes for more information.
- * - {@link StringOptionConfig}
- * - {@link NumberOptionConfig}
- * - {@link ArrayOptionConfig}
- * - {@link BooleanOptionConfig}
- *
- * @typeParam TCoerce The return type of the `coerce` function if provided.
- */
-export type OptionConfig<TCoerce = any, TChoices = any[], TObjectProps extends Record<string, OptionConfig> = Record<string, any>> = StringOptionConfig<TCoerce, TChoices> | NumberOptionConfig<TCoerce, TChoices> | ArrayOptionConfig<TCoerce, TChoices> | BooleanOptionConfig<TCoerce, TChoices> | ObjectOptionConfig<TCoerce, TObjectProps>;

package/src/lib/option-types/option-config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"option-config.js","sourceRoot":"","sources":["../../../../../../packages/parser/src/lib/option-types/option-config.ts"],"names":[],"mappings":""}

package/src/lib/option-types/string.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"string.js","sourceRoot":"","sources":["../../../../../../packages/parser/src/lib/option-types/string.ts"],"names":[],"mappings":""}