cli-forge 1.2.2 → 1.3.0

package/dist/lib/resolve-prompts.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePrompts = resolvePrompts;
+/**
+ * Collects options that need prompting, matches them to providers,
+ * executes prompts, and returns the prompted values.
+ */
+async function resolvePrompts(opts) {
+    const { configuredOptions, configuredImplies, promptConfigs, providers, currentArgs, } = opts;
+    // Step 1: Collect promptable options
+    const promptableOptions = [];
+    for (const [name, config] of Object.entries(configuredOptions)) {
+        // Skip internal options
+        if (name === 'help' ||
+            name === 'version' ||
+            name === 'unmatched' ||
+            name === '--') {
+            continue;
+        }
+        // Already has a value — skip unless prompt is explicitly true/string
+        const hasValue = currentArgs[name] !== undefined;
+        const promptSetting = promptConfigs.get(name);
+        let resolved;
+        if (typeof promptSetting === 'function') {
+            resolved = promptSetting(currentArgs);
+            // Callback: null/undefined treated as false
+            if (resolved === null || resolved === undefined) {
+                continue;
+            }
+        }
+        else if (promptSetting !== undefined) {
+            // Static value
+            resolved = promptSetting;
+        }
+        else {
+            // Not specified: prompt only if required and missing value
+            if (hasValue)
+                continue;
+            const isRequired = config.required === true;
+            const isImplied = isOptionImplied(name, configuredImplies, currentArgs);
+            if (!isRequired && !isImplied)
+                continue;
+            if (providers.length === 0)
+                continue; // No providers, let validation handle it
+            resolved = true; // Will prompt
+        }
+        if (resolved === false)
+            continue;
+        if (hasValue && resolved !== true && typeof resolved !== 'string')
+            continue;
+        promptableOptions.push({
+            name,
+            config: {
+                ...config,
+                prompt: resolved === true ? true : resolved ?? undefined,
+            },
+        });
+    }
+    if (promptableOptions.length === 0) {
+        return {};
+    }
+    // Step 2: Match options to providers
+    const filteredProviders = providers.filter((p) => p.filter);
+    const fallbackProviders = providers.filter((p) => !p.filter);
+    const providerGroups = new Map();
+    const unmatchedOptions = [];
+    for (const option of promptableOptions) {
+        let matched = false;
+        for (const provider of filteredProviders) {
+            if (provider.filter(option.name, option.config)) {
+                if (!providerGroups.has(provider)) {
+                    providerGroups.set(provider, []);
+                }
+                providerGroups.get(provider).push(option);
+                matched = true;
+                break;
+            }
+        }
+        if (!matched) {
+            unmatchedOptions.push(option);
+        }
+    }
+    // Assign unmatched options to first fallback provider
+    if (unmatchedOptions.length > 0) {
+        if (fallbackProviders.length === 0) {
+            const names = unmatchedOptions.map((o) => `'${o.name}'`).join(', ');
+            throw new Error(`Option(s) ${names} require prompting but no prompt provider is available`);
+        }
+        const fallback = fallbackProviders[0];
+        if (!providerGroups.has(fallback)) {
+            providerGroups.set(fallback, []);
+        }
+        providerGroups.get(fallback).push(...unmatchedOptions);
+    }
+    // Step 3: Execute prompts
+    const results = {};
+    for (const [provider, options] of providerGroups) {
+        if (provider.promptBatch) {
+            const batchResults = await provider.promptBatch(options);
+            Object.assign(results, batchResults);
+        }
+        else if (provider.prompt) {
+            for (const option of options) {
+                results[option.name] = await provider.prompt(option);
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Check if an option is implied by another option that has been set.
+ */
+function isOptionImplied(name, configuredImplies, currentArgs) {
+    for (const [trigger, implied] of Object.entries(configuredImplies)) {
+        if (implied.has(name) && currentArgs[trigger] !== undefined) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=resolve-prompts.js.map

package/dist/lib/resolve-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-prompts.js","sourceRoot":"","sources":["../../src/lib/resolve-prompts.ts"],"names":[],"mappings":"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"}

package/dist/lib/test-harness.js

@@ -9,7 +9,7 @@ const internal_cli_1 = require("./internal-cli");
 class TestHarness {
     cli;
     constructor(cli) {
-        if (cli instanceof internal_cli_1.InternalCLI) {
+        if (internal_cli_1.InternalCLI.isInternalCLI(cli)) {
             this.cli = cli;
             mockHandler(cli);
         }

package/dist/lib/test-harness.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-harness.js","sourceRoot":"","sources":["../../src/lib/test-harness.ts"],"names":[],"mappings":";;;AACA,iDAA6C;AA8B7C;;;GAGG;AACH,MAAa,WAAW;IACd,GAAG,CAAiB;IAE5B,YAAY,GAAW;QACrB,IAAI,GAAG,YAAY,0BAAW,EAAE,CAAC;YAC/B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;YACf,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAc;QACxB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAExC,OAAO;YACL,IAAI,EAAE,IAAI;YACV,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY;SACpC,CAAC;IACJ,CAAC;CACF;AAtBD,kCAsBC;AAED,SAAS,WAAW,CAAC,GAAgB;IACnC,IAAI,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,CAAC;QAC/B,GAAG,CAAC,aAAa,CAAC,OAAO,GAAG,GAAG,EAAE;YAC/B,6BAA6B;QAC/B,CAAC,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,kBAAkB,EAAE,CAAC;QAC7C,WAAW,CAAC,GAAG,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}
+{"version":3,"file":"test-harness.js","sourceRoot":"","sources":["../../src/lib/test-harness.ts"],"names":[],"mappings":";;;AACA,iDAA6C;AA8B7C;;;GAGG;AACH,MAAa,WAAW;IACd,GAAG,CAAiB;IAE5B,YAAY,GAAW;QACrB,IAAI,0BAAW,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;YACf,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAc;QACxB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAExC,OAAO;YACL,IAAI,EAAE,IAAI;YACV,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY;SACpC,CAAC;IACJ,CAAC;CACF;AAtBD,kCAsBC;AAED,SAAS,WAAW,CAAC,GAAgB;IACnC,IAAI,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,CAAC;QAC/B,GAAG,CAAC,aAAa,CAAC,OAAO,GAAG,GAAG,EAAE;YAC/B,6BAA6B;QAC/B,CAAC,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,kBAAkB,EAAE,CAAC;QAC7C,WAAW,CAAC,GAAG,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/prompt-providers/clack.d.ts

@@ -0,0 +1,29 @@
+import type { Readable, Writable } from 'node:stream';
+import type { PromptProvider } from '../lib/prompt-types';
+/**
+ * Options for {@link createClackPromptProvider}.
+ */
+export interface ClackPromptProviderOptions {
+    /**
+     * Custom input stream to read from instead of `process.stdin`.
+     * Useful for testing — pass a `Readable` with `isTTY = true` and
+     * a no-op `setRawMode` to emulate a terminal.
+     */
+    input?: Readable;
+    /**
+     * Custom output stream to write to instead of `process.stdout`.
+     */
+    output?: Writable;
+}
+/**
+ * Creates a prompt provider backed by @clack/prompts.
+ * Requires `@clack/prompts` as a peer dependency.
+ *
+ * The provider uses dynamic imports so that `@clack/prompts` is only
+ * loaded when prompting actually occurs.
+ */
+export declare function createClackPromptProvider(providerOptions?: ClackPromptProviderOptions): PromptProvider;
+/**
+ * Default clack prompt provider, uses stdin/stdout
+ */
+export declare const ClackPromptProvider: PromptProvider;

package/dist/prompt-providers/clack.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClackPromptProvider = void 0;
+exports.createClackPromptProvider = createClackPromptProvider;
+/**
+ * Creates a prompt provider backed by @clack/prompts.
+ * Requires `@clack/prompts` as a peer dependency.
+ *
+ * The provider uses dynamic imports so that `@clack/prompts` is only
+ * loaded when prompting actually occurs.
+ */
+function createClackPromptProvider(providerOptions) {
+    // Build the common stream options once; spread into every prompt call.
+    const streamOpts = {};
+    if (providerOptions?.input)
+        streamOpts.input = providerOptions.input;
+    if (providerOptions?.output)
+        streamOpts.output = providerOptions.output;
+    return {
+        async promptBatch(options) {
+            const clack = await import('@clack/prompts');
+            const results = {};
+            for (const option of options) {
+                const message = getLabel(option);
+                const defaultValue = getDefault(option.config);
+                let value;
+                if (option.config.type === 'boolean') {
+                    value = await clack.confirm({
+                        ...streamOpts,
+                        message,
+                        initialValue: typeof defaultValue === 'boolean' ? defaultValue : undefined,
+                    });
+                }
+                else if (hasChoices(option.config)) {
+                    const choices = getChoices(option.config);
+                    if (option.config.type === 'array') {
+                        value = await clack.multiselect({
+                            ...streamOpts,
+                            message,
+                            options: choices.map((c) => ({ value: c, label: String(c) })),
+                        });
+                    }
+                    else {
+                        value = await clack.select({
+                            ...streamOpts,
+                            message,
+                            options: choices.map((c) => ({ value: c, label: String(c) })),
+                        });
+                    }
+                }
+                else if (option.config.type === 'number') {
+                    const raw = await clack.text({
+                        ...streamOpts,
+                        message,
+                        placeholder: defaultValue !== undefined ? String(defaultValue) : undefined,
+                        defaultValue: defaultValue !== undefined ? String(defaultValue) : undefined,
+                        validate: (val) => {
+                            if (val && isNaN(Number(val))) {
+                                return 'Please enter a valid number';
+                            }
+                            return undefined;
+                        },
+                    });
+                    if (clack.isCancel(raw)) {
+                        clack.cancel('Operation cancelled.');
+                        throw new Error('Prompt cancelled by user');
+                    }
+                    value = raw !== undefined && raw !== '' ? Number(raw) : defaultValue;
+                }
+                else {
+                    // string, array without choices
+                    value = await clack.text({
+                        ...streamOpts,
+                        message,
+                        placeholder: defaultValue !== undefined ? String(defaultValue) : undefined,
+                        defaultValue: defaultValue !== undefined ? String(defaultValue) : undefined,
+                    });
+                }
+                // clack returns a Symbol when the user cancels (Ctrl+C)
+                if (clack.isCancel(value)) {
+                    clack.cancel('Operation cancelled.');
+                    throw new Error('Prompt cancelled by user');
+                }
+                results[option.name] = value;
+            }
+            return results;
+        },
+    };
+}
+/**
+ * Default clack prompt provider, uses stdin/stdout
+ */
+exports.ClackPromptProvider = createClackPromptProvider();
+/**
+ * Determine the label to show for a prompt option.
+ * Priority: prompt string > description > option name.
+ */
+function getLabel(option) {
+    if (typeof option.config.prompt === 'string') {
+        return option.config.prompt;
+    }
+    return option.config.description ?? option.name;
+}
+/**
+ * Extract the default value from an option config.
+ * Handles the three forms:
+ * - Primitive value directly
+ * - `{ value: T; description: string }` object
+ * - `{ factory: () => T; description: string }` object
+ */
+function getDefault(config) {
+    if (config.default === undefined)
+        return undefined;
+    if (typeof config.default === 'object' && config.default !== null) {
+        if ('factory' in config.default) {
+            return config.default.factory();
+        }
+        if ('value' in config.default) {
+            return config.default.value;
+        }
+    }
+    return config.default;
+}
+function hasChoices(config) {
+    return ('choices' in config &&
+        config['choices'] !== undefined);
+}
+function getChoices(config) {
+    const cfg = config;
+    const choices = cfg['choices'];
+    if (typeof choices === 'function') {
+        return choices();
+    }
+    return choices ?? [];
+}
+//# sourceMappingURL=clack.js.map

package/dist/prompt-providers/clack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clack.js","sourceRoot":"","sources":["../../src/prompt-providers/clack.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,16 +1,20 @@
 {
   "name": "cli-forge",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "dependencies": {
     "tslib": "^2.3.0",
-    "@cli-forge/parser": "1.2.2"
+    "@cli-forge/parser": "1.3.0"
   },
   "peerDependencies": {
+    "@clack/prompts": "*",
     "markdown-factory": "^0.2.0",
     "tsx": "^4.19.0",
     "zod": "^4.1.13"
   },
   "peerDependenciesMeta": {
+    "@clack/prompts": {
+      "optional": true
+    },
     "markdown-factory": {
       "optional": true,
       "dev": true
@@ -53,6 +57,11 @@
       "require": "./dist/middleware/*.js",
       "types": "./dist/middleware/*.d.ts"
     },
+    "./prompt-providers/clack": {
+      "require": "./dist/prompt-providers/clack.js",
+      "types": "./dist/prompt-providers/clack.d.ts",
+      "import": "./dist/prompt-providers/clack.js"
+    },
     "./package.json": "./package.json"
   },
   "publishConfig": {

package/src/bin/commands/generate-documentation.ts

@@ -386,19 +386,7 @@ async function importMarkdownFactory(): Promise<mdfactory> {
 }
 
 function isCLI(obj: unknown): obj is InternalCLI {
-  if (obj instanceof InternalCLI) {
-    return true;
-  }
-  if (typeof obj !== 'object' || !obj) {
-    return false;
-  }
-  if (!('constructor' in obj)) {
-    return false;
-  }
-  if (!('name' in obj.constructor)) {
-    return false;
-  }
-  return obj.constructor.name === InternalCLI.name;
+  return InternalCLI.isInternalCLI(obj);
 }
 
 function getExamplesFragment(

package/src/index.ts

@@ -9,5 +9,6 @@ export type {
   ExtractChildren,
 } from './lib/composable-builder';
 export type { ArgumentsOf } from './lib/utils';
+export type { PromptConfig, PromptOptionConfig, PromptOption, PromptProvider } from './lib/prompt-types';
 export { ConfigurationProviders } from './lib/configuration-providers';
 export type { LocalizationDictionary, LocalizationFunction } from '@cli-forge/parser';

package/src/lib/composable-builder.ts

@@ -19,7 +19,7 @@ export type ExtractArgs<T> = T extends CLI<infer A, any, any, any> ? A : never;
  */
 export type ComposableBuilder<
   TArgs2 extends ParsedArgs,
-  // eslint-disable-next-line @typescript-eslint/ban-types
+  // eslint-disable-next-line @typescript-eslint/no-empty-object-type
   TAddedChildren = {}
 > = <TInit extends ParsedArgs, THandlerReturn, TChildren, TParent>(
   init: CLI<TInit, THandlerReturn, TChildren, TParent>
@@ -39,11 +39,11 @@ export type ComposableBuilder<
  */
 export function makeComposableBuilder<
   TArgs2 extends ParsedArgs,
-  // eslint-disable-next-line @typescript-eslint/ban-types
+  // eslint-disable-next-line @typescript-eslint/no-empty-object-type
   TChildren2 = {}
 >(
   fn: (
-    // eslint-disable-next-line @typescript-eslint/ban-types
+    // eslint-disable-next-line @typescript-eslint/no-empty-object-type
     init: CLI<ParsedArgs, any, {}, any>
   ) => CLI<TArgs2, any, TChildren2, any>
 ) {