@mojir/dvala 0.0.15 → 0.0.16

package/dist/cli/cli.js

@@ -477,7 +477,7 @@ function findAllOccurrences(input, pattern) {
 }
 //#endregion
 //#region package.json
-var version = "0.0.15";
+var version = "0.0.16";
 //#endregion
 //#region src/typeGuards/string.ts
 function isString(value, options = {}) {
@@ -24481,6 +24481,128 @@ const standardEffects = {
 				"-effect-dvala.io.read-stdin",
 				"-effect-dvala.io.print",
 				"-effect-dvala.io.println",
+				"-effect-dvala.io.pick",
+				"-effect-dvala.io.confirm",
+				"perform",
+				"effect"
+			]
+		}
+	},
+	"dvala.io.pick": {
+		handler: (args, k, sourceCodeInfo) => {
+			const items = args[0];
+			const options = args[1];
+			if (!Array.isArray(items)) throw new DvalaError(`dvala.io.pick: first argument must be an array, got ${typeof items}`, sourceCodeInfo);
+			if (items.length === 0) throw new DvalaError("dvala.io.pick: items array must not be empty", sourceCodeInfo);
+			for (let i = 0; i < items.length; i++) if (typeof items[i] !== "string") throw new DvalaError(`dvala.io.pick: items[${i}] must be a string, got ${typeof items[i]}`, sourceCodeInfo);
+			let promptMessage;
+			let defaultIndex;
+			if (options !== void 0) {
+				if (typeof options !== "object" || options === null || Array.isArray(options)) throw new DvalaError(`dvala.io.pick: second argument must be an object, got ${typeof options}`, sourceCodeInfo);
+				const opts = options;
+				if (opts["prompt"] !== void 0) {
+					if (typeof opts["prompt"] !== "string") throw new DvalaError("dvala.io.pick: options.prompt must be a string", sourceCodeInfo);
+					promptMessage = opts["prompt"];
+				}
+				if (opts["default"] !== void 0) {
+					if (typeof opts["default"] !== "number" || !Number.isInteger(opts["default"])) throw new DvalaError("dvala.io.pick: options.default must be an integer", sourceCodeInfo);
+					defaultIndex = opts["default"];
+					if (defaultIndex < 0 || defaultIndex >= items.length) throw new DvalaError(`dvala.io.pick: options.default (${defaultIndex}) is out of bounds for array of length ${items.length}`, sourceCodeInfo);
+				}
+			}
+			if (typeof globalThis.prompt === "function") {
+				const listLines = items.map((item, i) => `${i}: ${item}`).join("\n");
+				const message = `${promptMessage ?? "Choose an item:"}${defaultIndex !== void 0 ? ` [default: ${defaultIndex}]` : ""}\n${listLines}`;
+				const result = globalThis.prompt(message);
+				if (result === null) return {
+					type: "Value",
+					value: null,
+					k
+				};
+				const trimmed = result.trim();
+				if (trimmed === "") return {
+					type: "Value",
+					value: defaultIndex !== void 0 ? defaultIndex : null,
+					k
+				};
+				const parsed = Number(trimmed);
+				if (!Number.isInteger(parsed) || parsed < 0 || parsed >= items.length) throw new DvalaError(`dvala.io.pick: invalid selection "${trimmed}"`, sourceCodeInfo);
+				return {
+					type: "Value",
+					value: parsed,
+					k
+				};
+			}
+			throw new DvalaError("dvala.io.pick is not supported in this environment. In Node.js, register a \"dvala.io.pick\" host handler.", sourceCodeInfo);
+		},
+		arity: {
+			min: 1,
+			max: 2
+		},
+		docs: {
+			category: "effect",
+			description: "Presents a numbered list of items and asks the user to choose one. In browsers uses `window.prompt()`. In Node.js, register a host handler. Resumes with the index of the chosen item, or `null` if the user cancels.",
+			returns: { type: ["integer", "null"] },
+			args: {
+				items: {
+					type: "array",
+					description: "Non-empty array of strings to display."
+				},
+				options: {
+					type: "object",
+					description: "Optional settings: `prompt` (string label) and `default` (integer index to use when the user submits an empty input)."
+				}
+			},
+			variants: [{ argumentNames: ["items"] }, { argumentNames: ["items", "options"] }],
+			examples: ["effect(dvala.io.pick)"],
+			seeAlso: [
+				"-effect-dvala.io.read-line",
+				"-effect-dvala.io.confirm",
+				"perform",
+				"effect"
+			]
+		}
+	},
+	"dvala.io.confirm": {
+		handler: (args, k, sourceCodeInfo) => {
+			const question = args[0];
+			const options = args[1];
+			if (typeof question !== "string") throw new DvalaError(`dvala.io.confirm: first argument must be a string, got ${typeof question}`, sourceCodeInfo);
+			if (options !== void 0) {
+				if (typeof options !== "object" || options === null || Array.isArray(options)) throw new DvalaError(`dvala.io.confirm: second argument must be an object, got ${typeof options}`, sourceCodeInfo);
+				const opts = options;
+				if (opts["default"] !== void 0 && typeof opts["default"] !== "boolean") throw new DvalaError("dvala.io.confirm: options.default must be a boolean", sourceCodeInfo);
+			}
+			if (typeof globalThis.confirm === "function") return {
+				type: "Value",
+				value: globalThis.confirm(question),
+				k
+			};
+			throw new DvalaError("dvala.io.confirm is not supported in this environment. In Node.js, register a \"dvala.io.confirm\" host handler.", sourceCodeInfo);
+		},
+		arity: {
+			min: 1,
+			max: 2
+		},
+		docs: {
+			category: "effect",
+			description: "Asks the user a yes/no question. In browsers uses `window.confirm()` and returns `true` (OK) or `false` (Cancel). In Node.js, register a host handler. The optional `default` hints the preferred answer to host handlers (e.g. for rendering `[Y/n]` in a CLI), but has no effect on the browser implementation.",
+			returns: { type: "boolean" },
+			args: {
+				question: {
+					type: "string",
+					description: "The yes/no question to present."
+				},
+				options: {
+					type: "object",
+					description: "Optional settings: `default` (boolean, hints the preferred answer for host handlers)."
+				}
+			},
+			variants: [{ argumentNames: ["question"] }, { argumentNames: ["question", "options"] }],
+			examples: ["effect(dvala.io.confirm)"],
+			seeAlso: [
+				"-effect-dvala.io.read-line",
+				"-effect-dvala.io.pick",
 				"perform",
 				"effect"
 			]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mojir/dvala",
-  "version": "0.0.15",
+  "version": "0.0.16",
   "description": "dvala",
   "author": "Albert Mojir",
   "license": "MIT",
@@ -138,7 +138,9 @@
     "dvala": "node ./dist/cli/cli.js",
     "dev": "npx serve docs -p 9901",
     "test:e2e": "npx playwright test",
+    "test:e2e:prod": "E2E_BASE_URL=https://mojir.github.io/dvala npx playwright test",
     "test:e2e:headed": "npx playwright test --headed",
+    "test:e2e:prod:headed": "E2E_BASE_URL=https://mojir.github.io/dvala npx playwright test --headed",
     "lcov": "open-cli ./coverage/index.html",
     "mcp:inspect": "npx @modelcontextprotocol/inspector node ./dist/mcp-server/server.js"
   },