@optique/clack 1.3.0-dev.2417 → 1.3.0-dev.2418

package/dist/index.cjs

@@ -58,7 +58,8 @@ function getPromptFunctions() {
 * Wraps a parser with an interactive Clack prompt fallback.
 *
 * @param parser Inner parser that reads CLI values.
-* @param config Type-safe Clack prompt configuration.
+* @param config Type-safe Clack prompt configuration, or a configuration
+*               derived from dependency sources via `derivePromptConfig()`.
 * @returns A parser with interactive prompt fallback, always in async mode.
 * @throws {Error} If prompt execution fails with an unexpected error or if the
 *                 inner parser throws while parsing or completing.
@@ -192,4 +193,16 @@ function normalizeOptions(options) {
 }
 
 //#endregion
+Object.defineProperty(exports, 'derivePromptConfig', {
+  enumerable: true,
+  get: function () {
+    return __optique_prompt.derivePromptConfig;
+  }
+});
+Object.defineProperty(exports, 'isDerivedPromptConfig', {
+  enumerable: true,
+  get: function () {
+    return __optique_prompt.isDerivedPromptConfig;
+  }
+});
 exports.prompt = prompt;

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { FluentParser } from "@optique/core/fluent";
 import { Mode, Parser } from "@optique/core/parser";
-import { PromptCondition } from "@optique/prompt";
+import { DerivePromptConfigContext, DerivePromptConfigOptions, DerivePromptConfigsContext, DerivePromptConfigsOptions, DerivedPromptConfig, DerivedPromptConfig as DerivedPromptConfig$1, PromptCondition, derivePromptConfig, isDerivedPromptConfig } from "@optique/prompt";
 
 //#region src/index.d.ts
 
@@ -146,16 +146,28 @@ type StringPromptConfig = TextConfig | PasswordConfig | SelectConfig;
  */
 type PromptConfig<T> = BasePromptConfig<Exclude<T, null | undefined>> & PromptCondition<T>;
 type BasePromptConfig<T> = T extends boolean ? ConfirmConfig : T extends number ? NumberPromptConfig : T extends string ? StringPromptConfig : T extends readonly string[] ? MultiselectConfig : never;
+/**
+ * Union of every prompt configuration this package can execute,
+ * regardless of the parser value type.
+ *
+ * Derived prompt configurations resolve against this union: the adapter's
+ * configuration type supplies the resolver's return type, so a resolver
+ * may produce any prompt kind the adapter supports.
+ *
+ * @since 1.3.0
+ */
+type RuntimePromptConfig = ConfirmConfig | NumberPromptConfig | StringPromptConfig | MultiselectConfig;
 /**
  * Wraps a parser with an interactive Clack prompt fallback.
  *
  * @param parser Inner parser that reads CLI values.
- * @param config Type-safe Clack prompt configuration.
+ * @param config Type-safe Clack prompt configuration, or a configuration
+ *               derived from dependency sources via `derivePromptConfig()`.
  * @returns A parser with interactive prompt fallback, always in async mode.
  * @throws {Error} If prompt execution fails with an unexpected error or if the
  *                 inner parser throws while parsing or completing.
  * @since 1.2.0
  */
-declare function prompt<M extends Mode, TValue, TState>(parser: Parser<M, TValue, TState>, config: PromptConfig<TValue>): FluentParser<"async", TValue, TState>;
+declare function prompt<M extends Mode, TValue, TState>(parser: Parser<M, TValue, TState>, config: PromptConfig<TValue> | DerivedPromptConfig$1<RuntimePromptConfig, NoInfer<TValue>>): FluentParser<"async", TValue, TState>;
 //#endregion
-export { ConfirmConfig, MultiselectConfig, NumberPromptConfig, Option, PasswordConfig, PromptConfig, SelectConfig, StringPromptConfig, TextConfig, prompt };
+export { ConfirmConfig, type DerivePromptConfigContext, type DerivePromptConfigOptions, type DerivePromptConfigsContext, type DerivePromptConfigsOptions, type DerivedPromptConfig, MultiselectConfig, NumberPromptConfig, Option, PasswordConfig, PromptConfig, RuntimePromptConfig, SelectConfig, StringPromptConfig, TextConfig, derivePromptConfig, isDerivedPromptConfig, prompt };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { PromptCondition } from "@optique/prompt";
+import { DerivePromptConfigContext, DerivePromptConfigOptions, DerivePromptConfigsContext, DerivePromptConfigsOptions, DerivedPromptConfig, DerivedPromptConfig as DerivedPromptConfig$1, PromptCondition, derivePromptConfig, isDerivedPromptConfig } from "@optique/prompt";
 import { FluentParser } from "@optique/core/fluent";
 import { Mode, Parser } from "@optique/core/parser";
 
@@ -146,16 +146,28 @@ type StringPromptConfig = TextConfig | PasswordConfig | SelectConfig;
  */
 type PromptConfig<T> = BasePromptConfig<Exclude<T, null | undefined>> & PromptCondition<T>;
 type BasePromptConfig<T> = T extends boolean ? ConfirmConfig : T extends number ? NumberPromptConfig : T extends string ? StringPromptConfig : T extends readonly string[] ? MultiselectConfig : never;
+/**
+ * Union of every prompt configuration this package can execute,
+ * regardless of the parser value type.
+ *
+ * Derived prompt configurations resolve against this union: the adapter's
+ * configuration type supplies the resolver's return type, so a resolver
+ * may produce any prompt kind the adapter supports.
+ *
+ * @since 1.3.0
+ */
+type RuntimePromptConfig = ConfirmConfig | NumberPromptConfig | StringPromptConfig | MultiselectConfig;
 /**
  * Wraps a parser with an interactive Clack prompt fallback.
  *
  * @param parser Inner parser that reads CLI values.
- * @param config Type-safe Clack prompt configuration.
+ * @param config Type-safe Clack prompt configuration, or a configuration
+ *               derived from dependency sources via `derivePromptConfig()`.
  * @returns A parser with interactive prompt fallback, always in async mode.
  * @throws {Error} If prompt execution fails with an unexpected error or if the
  *                 inner parser throws while parsing or completing.
  * @since 1.2.0
  */
-declare function prompt<M extends Mode, TValue, TState>(parser: Parser<M, TValue, TState>, config: PromptConfig<TValue>): FluentParser<"async", TValue, TState>;
+declare function prompt<M extends Mode, TValue, TState>(parser: Parser<M, TValue, TState>, config: PromptConfig<TValue> | DerivedPromptConfig$1<RuntimePromptConfig, NoInfer<TValue>>): FluentParser<"async", TValue, TState>;
 //#endregion
-export { ConfirmConfig, MultiselectConfig, NumberPromptConfig, Option, PasswordConfig, PromptConfig, SelectConfig, StringPromptConfig, TextConfig, prompt };
+export { ConfirmConfig, type DerivePromptConfigContext, type DerivePromptConfigOptions, type DerivePromptConfigsContext, type DerivePromptConfigsOptions, type DerivedPromptConfig, MultiselectConfig, NumberPromptConfig, Option, PasswordConfig, PromptConfig, RuntimePromptConfig, SelectConfig, StringPromptConfig, TextConfig, derivePromptConfig, isDerivedPromptConfig, prompt };

package/dist/index.js

@@ -1,6 +1,6 @@
 import { confirm, isCancel, multiselect, password, select, text } from "@clack/prompts";
 import { message } from "@optique/core/message";
-import { createPromptAdapter } from "@optique/prompt";
+import { createPromptAdapter, derivePromptConfig, isDerivedPromptConfig } from "@optique/prompt";
 
 //#region src/index.ts
 const promptFunctionsOverrideSymbol = Symbol.for("@optique/clack/prompt-functions");
@@ -35,7 +35,8 @@ function getPromptFunctions() {
 * Wraps a parser with an interactive Clack prompt fallback.
 *
 * @param parser Inner parser that reads CLI values.
-* @param config Type-safe Clack prompt configuration.
+* @param config Type-safe Clack prompt configuration, or a configuration
+*               derived from dependency sources via `derivePromptConfig()`.
 * @returns A parser with interactive prompt fallback, always in async mode.
 * @throws {Error} If prompt execution fails with an unexpected error or if the
 *                 inner parser throws while parsing or completing.
@@ -169,4 +170,4 @@ function normalizeOptions(options) {
 }
 
 //#endregion
-export { prompt };
+export { derivePromptConfig, isDerivedPromptConfig, prompt };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/clack",
-  "version": "1.3.0-dev.2417",
+  "version": "1.3.0-dev.2418",
   "description": "Interactive prompt support for Optique via Clack",
   "keywords": [
     "CLI",
@@ -62,12 +62,12 @@
   "sideEffects": false,
   "dependencies": {
     "@clack/prompts": "^1.6.0",
-    "@optique/core": "1.3.0-dev.2417+6b19e980",
-    "@optique/prompt": "1.3.0-dev.2417+6b19e980"
+    "@optique/core": "1.3.0-dev.2418+afa5cda1",
+    "@optique/prompt": "1.3.0-dev.2418+afa5cda1"
   },
   "devDependencies": {
-    "@optique/env": "1.3.0-dev.2417+6b19e980",
-    "@optique/run": "1.3.0-dev.2417+6b19e980",
+    "@optique/env": "1.3.0-dev.2418+afa5cda1",
+    "@optique/run": "1.3.0-dev.2418+afa5cda1",
     "@types/node": "^24.0.0",
     "fast-check": "^4.7.0",
     "tsdown": "^0.13.0",