scenv-inquirer 0.3.3 → 0.4.1

package/README.md

@@ -1,8 +1,8 @@
 # scenv-inquirer
 
-Inquirer-based prompts for [scenv](https://www.npmjs.com/package/scenv): variable prompts and save/context callbacks.
+Inquirer-based prompts for [scenv](https://www.npmjs.com/package/scenv): variable prompts (and optional default prompt callback).
 
-Use with scenv when you want interactive prompts for variable values and for "save to context?" / "which context?" flows.
+Use with scenv when you want interactive prompts for variable values. Saving is controlled by scenv's `saveContextTo` config (path or context name); there are no "save?" or "which context?" callbacks in scenv.
 
 ## Install
 
@@ -18,7 +18,7 @@ npm install scenv scenv-inquirer inquirer
 
 ### Variable prompt
 
-Use `prompt()` as the `prompt` option for a variable. Scenv calls it with `(name, defaultValue)` when it needs to ask the user.
+Use `prompt()` as the `prompt` option for a variable. Scenv calls it with `(name, defaultValue)` when it needs to ask the user. **Scenv does not prompt by default** — enable prompting via config (e.g. `configure({ prompt: "fallback" })`, `SCENV_PROMPT=fallback`, or `prompt` in `scenv.config.json`).
 
 ```ts
 import { scenv } from "scenv";
@@ -29,7 +29,8 @@ const apiUrl = scenv("API URL", {
   prompt: prompt(),
 });
 
-const url = await apiUrl.get(); // prompts via inquirer if no env/context/default
+configure({ prompt: "fallback" }); // or "always" / "no-env"
+const url = await apiUrl.get(); // prompts via inquirer if no env/context
 ```
 
 ### Default prompt for all variables
@@ -45,11 +46,7 @@ configure({ callbacks: { defaultPrompt: prompt() } });
 
 Variable-level `prompt` overrides this default.
 
-### Save and context callbacks
-
-`askWhetherToSave()` and `askContext()` return functions for scenv's `onAskWhetherToSave` and `onAskContext` callbacks. Use them when `shouldSavePrompt` is `ask` or when `saveContextTo: "ask"`.
-
-**`callbacks()`** wires all of the above in one go:
+**`callbacks()`** returns an object you can pass to `configure()` so all variables use inquirer when they need a value:
 
 ```ts
 import { configure } from "scenv";
@@ -60,20 +57,14 @@ configure(callbacks());
 configure({ ...yourConfig, ...callbacks() });
 ```
 
-This sets:
-
-- **defaultPrompt** – inquirer for variable values when no value is resolved
-- **onAskWhetherToSave** – "Save '{name}' for next time?" (y/n). Only used when `shouldSavePrompt` is "ask".
-- **onAskContext** – "Save to which context?" (list or new). Used when `saveContextTo` is "ask" or when saving after prompt and destination is "ask".
+This sets **defaultPrompt** so variable values are prompted via inquirer when no value is resolved from set/env/context. You must still enable prompting in scenv (e.g. `configure({ prompt: "fallback" })`).
 
 ## API
 
 | Export | Description |
 |--------|-------------|
 | `prompt()` | Returns `(name, defaultValue) => Promise<T>` for use as variable `prompt` or `callbacks.defaultPrompt`. |
-| `askWhetherToSave()` | Returns `onAskWhetherToSave`: asks whether to save (y/n). Where to save is handled by `saveContextTo` or `onAskContext`. |
-| `askContext()` | Returns `onAskContext`: asks which context to save to. |
-| `callbacks()` | Returns `{ callbacks: { defaultPrompt, onAskWhetherToSave, onAskContext } }`. |
+| `callbacks()` | Returns `{ callbacks: { defaultPrompt } }` for use with `configure()`. |
 
 ## License
 

package/dist/index.cjs

@@ -30,8 +30,6 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  askContext: () => askContext,
-  askWhetherToSave: () => askWhetherToSave,
   callbacks: () => callbacks,
   prompt: () => prompt
 });
@@ -51,53 +49,11 @@ function prompt() {
     return value;
   });
 }
-function askWhetherToSave() {
-  return async (name, _value) => {
-    const { save } = await import_inquirer.default.prompt([
-      {
-        type: "confirm",
-        name: "save",
-        message: `Save "${name}" for next time?`,
-        default: true
-      }
-    ]);
-    return save;
-  };
-}
-function askContext() {
-  return async (name, contextNames) => {
-    const choices = [...contextNames];
-    if (choices.length === 0) choices.push("default");
-    choices.push("(new context)");
-    const { context } = await import_inquirer.default.prompt([
-      {
-        type: "list",
-        name: "context",
-        message: `Save "${name}" to which context?`,
-        choices
-      }
-    ]);
-    if (context === "(new context)") {
-      const { newContext } = await import_inquirer.default.prompt([
-        { type: "input", name: "newContext", message: "Context name:", default: "default" }
-      ]);
-      return newContext.trim() || "default";
-    }
-    return context;
-  };
-}
 function callbacks() {
-  const cbs = {
-    defaultPrompt: prompt(),
-    onAskWhetherToSave: askWhetherToSave(),
-    onAskContext: askContext()
-  };
-  return { callbacks: cbs };
+  return { callbacks: { defaultPrompt: prompt() } };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  askContext,
-  askWhetherToSave,
   callbacks,
   prompt
 });

package/dist/index.d.cts

@@ -4,9 +4,9 @@ import { ScenvCallbacks, DefaultPromptFn } from 'scenv';
  * Returns an inquirer-based prompt function for use with scenv variables. Use as the
  * variable's `prompt` option or as `callbacks.defaultPrompt`. Scenv calls it with the
  * variable name and default value when prompting; this shows an inquirer input prompt.
- * Returned value is a string; use a validator (e.g. scenv-zod) for type coercion.
+ * Returned value is a string; use a parser (e.g. scenv-zod) for type coercion.
  *
- * @typeParam T - Value type (default string). Cast or validate in your validator.
+ * @typeParam T - Value type (default string). Cast or parse in your parser.
  * @returns A function `(name, defaultValue) => Promise<T>` suitable for scenv's prompt or defaultPrompt.
  *
  * @example
@@ -15,29 +15,10 @@ import { ScenvCallbacks, DefaultPromptFn } from 'scenv';
  */
 declare function prompt<T = string>(): DefaultPromptFn;
 /**
- * Returns a function suitable for scenv's {@link ScenvCallbacks.onAskWhetherToSave} callback.
- * Uses inquirer confirm to ask "Save '{name}' for next time?" (y/n). Where to save is
- * determined by config.saveContextTo or the onAskContext callback when saveContextTo is "ask".
- * Only called when {@link ScenvConfig.shouldSavePrompt} is "ask" and the user was just prompted. ("always" saves without asking.)
+ * Returns an object with the defaultPrompt callback for scenv. Pass to {@link configure}
+ * to use inquirer for variable prompts. Variable-level `prompt` overrides defaultPrompt.
  *
- * @returns A function `(name, value) => Promise<boolean>`: true to save, false to skip.
- */
-declare function askWhetherToSave(): NonNullable<ScenvCallbacks["onAskWhetherToSave"]>;
-/**
- * Returns a function suitable for scenv's {@link ScenvCallbacks.onAskContext} callback.
- * Uses inquirer list to choose a context from contextNames, with a "(new context)" option
- * that prompts for a new name. Used when {@link ScenvConfig.saveContextTo} is "ask" or
- * when saving after a prompt and the destination is "ask".
- *
- * @returns A function `(name, contextNames) => Promise<string>` that returns the chosen context name.
- */
-declare function askContext(): NonNullable<ScenvCallbacks["onAskContext"]>;
-/**
- * Returns an object with all inquirer-based callbacks for scenv. Pass to {@link configure}
- * to use inquirer for variable prompts, "save for next time?", and "which context?".
- * Variable-level `prompt` overrides defaultPrompt.
- *
- * @returns `{ callbacks: { defaultPrompt, onAskWhetherToSave, onAskContext } }` – spread into configure() or merge with other config.
+ * @returns `{ callbacks: { defaultPrompt } }` – spread into configure() or merge with other config.
  *
  * @example
  * import { configure } from "scenv";
@@ -49,4 +30,4 @@ declare function callbacks(): {
     callbacks: ScenvCallbacks;
 };
 
-export { askContext, askWhetherToSave, callbacks, prompt };
+export { callbacks, prompt };

package/dist/index.d.ts

@@ -4,9 +4,9 @@ import { ScenvCallbacks, DefaultPromptFn } from 'scenv';
  * Returns an inquirer-based prompt function for use with scenv variables. Use as the
  * variable's `prompt` option or as `callbacks.defaultPrompt`. Scenv calls it with the
  * variable name and default value when prompting; this shows an inquirer input prompt.
- * Returned value is a string; use a validator (e.g. scenv-zod) for type coercion.
+ * Returned value is a string; use a parser (e.g. scenv-zod) for type coercion.
  *
- * @typeParam T - Value type (default string). Cast or validate in your validator.
+ * @typeParam T - Value type (default string). Cast or parse in your parser.
  * @returns A function `(name, defaultValue) => Promise<T>` suitable for scenv's prompt or defaultPrompt.
  *
  * @example
@@ -15,29 +15,10 @@ import { ScenvCallbacks, DefaultPromptFn } from 'scenv';
  */
 declare function prompt<T = string>(): DefaultPromptFn;
 /**
- * Returns a function suitable for scenv's {@link ScenvCallbacks.onAskWhetherToSave} callback.
- * Uses inquirer confirm to ask "Save '{name}' for next time?" (y/n). Where to save is
- * determined by config.saveContextTo or the onAskContext callback when saveContextTo is "ask".
- * Only called when {@link ScenvConfig.shouldSavePrompt} is "ask" and the user was just prompted. ("always" saves without asking.)
+ * Returns an object with the defaultPrompt callback for scenv. Pass to {@link configure}
+ * to use inquirer for variable prompts. Variable-level `prompt` overrides defaultPrompt.
  *
- * @returns A function `(name, value) => Promise<boolean>`: true to save, false to skip.
- */
-declare function askWhetherToSave(): NonNullable<ScenvCallbacks["onAskWhetherToSave"]>;
-/**
- * Returns a function suitable for scenv's {@link ScenvCallbacks.onAskContext} callback.
- * Uses inquirer list to choose a context from contextNames, with a "(new context)" option
- * that prompts for a new name. Used when {@link ScenvConfig.saveContextTo} is "ask" or
- * when saving after a prompt and the destination is "ask".
- *
- * @returns A function `(name, contextNames) => Promise<string>` that returns the chosen context name.
- */
-declare function askContext(): NonNullable<ScenvCallbacks["onAskContext"]>;
-/**
- * Returns an object with all inquirer-based callbacks for scenv. Pass to {@link configure}
- * to use inquirer for variable prompts, "save for next time?", and "which context?".
- * Variable-level `prompt` overrides defaultPrompt.
- *
- * @returns `{ callbacks: { defaultPrompt, onAskWhetherToSave, onAskContext } }` – spread into configure() or merge with other config.
+ * @returns `{ callbacks: { defaultPrompt } }` – spread into configure() or merge with other config.
  *
  * @example
  * import { configure } from "scenv";
@@ -49,4 +30,4 @@ declare function callbacks(): {
     callbacks: ScenvCallbacks;
 };
 
-export { askContext, askWhetherToSave, callbacks, prompt };
+export { callbacks, prompt };

package/dist/index.js

@@ -14,52 +14,10 @@ function prompt() {
     return value;
   });
 }
-function askWhetherToSave() {
-  return async (name, _value) => {
-    const { save } = await inquirer.prompt([
-      {
-        type: "confirm",
-        name: "save",
-        message: `Save "${name}" for next time?`,
-        default: true
-      }
-    ]);
-    return save;
-  };
-}
-function askContext() {
-  return async (name, contextNames) => {
-    const choices = [...contextNames];
-    if (choices.length === 0) choices.push("default");
-    choices.push("(new context)");
-    const { context } = await inquirer.prompt([
-      {
-        type: "list",
-        name: "context",
-        message: `Save "${name}" to which context?`,
-        choices
-      }
-    ]);
-    if (context === "(new context)") {
-      const { newContext } = await inquirer.prompt([
-        { type: "input", name: "newContext", message: "Context name:", default: "default" }
-      ]);
-      return newContext.trim() || "default";
-    }
-    return context;
-  };
-}
 function callbacks() {
-  const cbs = {
-    defaultPrompt: prompt(),
-    onAskWhetherToSave: askWhetherToSave(),
-    onAskContext: askContext()
-  };
-  return { callbacks: cbs };
+  return { callbacks: { defaultPrompt: prompt() } };
 }
 export {
-  askContext,
-  askWhetherToSave,
   callbacks,
   prompt
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scenv-inquirer",
-  "version": "0.3.3",
+  "version": "0.4.1",
   "description": "Inquirer prompt for scenv variables",
   "repository": {"type": "git", "url": "https://github.com/PKWadsy/scenv"},
   "publishConfig": {"access": "public", "provenance": true},