@orkestrel/terminal 0.0.19 → 0.0.21

package/dist/src/core/index.d.cts

@@ -579,6 +579,9 @@ export declare function isPrintable(character: string): boolean;
 /**
  * Narrows an unknown caught value to a {@link TerminalError}, so a caller can branch on its `code`.
  *
+ * @remarks
+ * Recognizes branded errors across package copies, including subclasses, and refuses transparent proxies.
+ *
  * @param value - The value to test (typically a `catch` binding or a rejected prompt call)
  * @returns True if `value` is a {@link TerminalError}; false otherwise
  *

package/dist/src/core/index.d.ts

@@ -579,6 +579,9 @@ export declare function isPrintable(character: string): boolean;
 /**
  * Narrows an unknown caught value to a {@link TerminalError}, so a caller can branch on its `code`.
  *
+ * @remarks
+ * Recognizes branded errors across package copies, including subclasses, and refuses transparent proxies.
+ *
  * @param value - The value to test (typically a `catch` binding or a rejected prompt call)
  * @returns True if `value` is a {@link TerminalError}; false otherwise
  *

package/dist/src/core/index.js

@@ -1,10 +1,10 @@
 import { CSI, ESC, STATUS_ICONS, createStyler, freezeStyle, strip, stripControls } from "@orkestrel/console";
-import { arrayOf, attempt, isArray, isBoolean, isError, isInstance, isNonEmptyString, isNumber, isRecord, isString, literalOf, parseJSON, rawShape, recordOf, stringShape } from "@orkestrel/contract";
+import { INTRINSICS, arrayOf, attempt, holds, isArray, isBoolean, isError, isFunction, isNonEmptyString, isNumber, isObject, isRecord, isString, literalOf, parseJSON, rawShape, recordOf, stringShape } from "@orkestrel/contract";
 import { Emitter } from "@orkestrel/emitter";
 import { createForm, isFieldError, isFormError, parseForm, serializeForm } from "@orkestrel/form";
 import { createSSEParser } from "@orkestrel/sse";
 import { createDatabase, createMemoryDriver } from "@orkestrel/database";
-//#region src/core/constants.ts
+// src/core/constants.ts
 /** Names the carriage return byte (`\r`, U+000D) — Enter on most terminals. */
 var RETURN = String.fromCharCode(13);
 /** Names the line feed byte (`\n`, U+000A) — Enter on some terminals / pasted input. */
@@ -259,8 +259,7 @@ var ACCEPT_EVENT_STREAM = "text/event-stream";
 * or oversized `data:` field cannot grow the buffer without bound (a memory-exhaustion guard).
 */
 var SSE_BUFFER_LIMIT = 1048576;
-//#endregion
-//#region src/core/errors.ts
+// src/core/errors.ts
 /**
 * Represents the error the terminal surfaces for its own refusals: parking on a destroyed or full broker, an
 * unusable driver stream, a manager routing fault, or a ctrl-c cancellation. A parked form's own
@@ -286,6 +285,7 @@ var TerminalError = class extends Error {
 	*/
 	constructor(code, message, context) {
 		super(message);
+		INTRINSICS.define(this, Symbol.for("@orkestrel/terminal.TerminalError"), { value: this });
 		this.name = "TerminalError";
 		this.code = code;
 		if (context !== void 0) this.context = context;
@@ -294,6 +294,9 @@ var TerminalError = class extends Error {
 /**
 * Narrows an unknown caught value to a {@link TerminalError}, so a caller can branch on its `code`.
 *
+* @remarks
+* Recognizes branded errors across package copies, including subclasses, and refuses transparent proxies.
+*
 * @param value - The value to test (typically a `catch` binding or a rejected prompt call)
 * @returns True if `value` is a {@link TerminalError}; false otherwise
 *
@@ -309,10 +312,17 @@ var TerminalError = class extends Error {
 * ```
 */
 function isTerminalError(value) {
-	return isInstance(value, TerminalError);
+	return holds(() => {
+		if (!isError(value) || INTRINSICS.prototype(value) === Error.prototype) return false;
+		const brand = INTRINSICS.describe(value, Symbol.for("@orkestrel/terminal.TerminalError"));
+		if (brand === void 0 || brand.value !== value) return false;
+		const code = INTRINSICS.reflect.read(value, "code");
+		if (code !== "EXPIRE" && code !== "CANCEL" && code !== "DRIVER" && code !== "DEADLOCK" && code !== "TARGET" && code !== "LIMIT" && code !== "DESTROYED") return false;
+		const context = INTRINSICS.reflect.read(value, "context");
+		return context === void 0 || isObject(context) || isFunction(context);
+	});
 }
-//#endregion
-//#region src/core/validators.ts
+// src/core/validators.ts
 /**
 * Narrows an unknown value to a {@link PendingFormStatus}.
 *
@@ -364,8 +374,7 @@ var isTerminalSnapshot = recordOf({
 	id: isNonEmptyString,
 	timeout: isNumber
 }, ["timeout"]);
-//#endregion
-//#region src/core/helpers.ts
+// src/core/helpers.ts
 /**
 * Decodes one keypress's bytes into a {@link KeyEvent} — total, never throws. A `Uint8Array` is
 * read as UTF-8; the resulting string is matched against the known control bytes and the CRLF pair
@@ -557,6 +566,7 @@ function sanitizeSchema(schema) {
 			case "datetime":
 			case "color":
 			case "confirm":
+			case "list":
 				fields.push({
 					...field,
 					...shared
@@ -842,11 +852,8 @@ function reduceConfirm(state, key) {
 		view: renderConfirmView(state),
 		status: "cancel"
 	};
-	let answer;
 	const choice = key.name?.toLowerCase();
-	if (key.name === "return") answer = state.default;
-	else if (choice === "y") answer = true;
-	else if (choice === "n") answer = false;
+	const answer = key.name === "return" ? state.default : choice === "y" ? true : choice === "n" ? false : void 0;
 	if (answer === void 0) return {
 		state,
 		view: renderConfirmView(state),
@@ -1285,8 +1292,7 @@ function serializeDestroy() {
 		data: ""
 	};
 }
-//#endregion
-//#region src/core/Prompt.ts
+// src/core/Prompt.ts
 /**
 * Implements the headless form broker. It parks live forms, exposes their serialized schemas,
 * applies remote answers to the authoritative form, and abandons a parked form on timeout, release,
@@ -1382,11 +1388,10 @@ var Prompt = class {
 			return;
 		}
 		if (isArray(ids)) {
-			let stopped = true;
-			for (const id of ids) {
+			const stopped = Iterator.from(ids).reduce((result, id) => {
 				const parked = this.#parked.get(id);
-				if (parked === void 0 || parked.pending.status !== "pending") stopped = false;
-			}
+				return parked !== void 0 && parked.pending.status === "pending" && result;
+			}, true);
 			for (const id of ids) this.#expire(id);
 			return stopped;
 		}
@@ -1477,8 +1482,23 @@ var Prompt = class {
 		return true;
 	}
 };
-//#endregion
-//#region src/core/PromptClient.ts
+// src/core/PromptAnswers.ts
+/** Holds the answer and refusal carried between attempts of one remote prompt. */
+var PromptAnswers = class {
+	#values;
+	#errors = [];
+	get values() {
+		return this.#values;
+	}
+	get errors() {
+		return this.#errors;
+	}
+	replace(values, errors) {
+		this.#values = values;
+		this.#errors = errors;
+	}
+};
+// src/core/PromptClient.ts
 /**
 * Implements the SSE form bridge. It ingests serialized forms from a remote broker without waiting
 * on a render, drives one form at a time through a local terminal, posts each answer back, and asks
@@ -1644,11 +1664,7 @@ var PromptClient = class {
 		this.#draining = true;
 		try {
 			while (!this.#destroyed) {
-				let queued;
-				for (const entry of this.#queue) {
-					queued = entry;
-					break;
-				}
+				const queued = this.#next();
 				if (queued === void 0) return;
 				const [id, schema] = queued;
 				this.#queue.delete(id);
@@ -1671,28 +1687,29 @@ var PromptClient = class {
 		}
 	}
 	async #render(id, schema) {
-		let values;
-		let errors = [];
+		const answers = new PromptAnswers();
 		while (this.#seen.has(id) && !this.#destroyed) {
-			const form = this.#createRenderingForm(schema, values);
+			const form = this.#createRenderingForm(schema, answers.values);
 			this.#active = {
 				id,
 				form,
 				stopped: false
 			};
-			for (const error of errors) form.invalidate(error.field, sanitizeDisplayText(error.message));
+			for (const error of answers.errors) form.invalidate(error.field, sanitizeDisplayText(error.message));
 			const submitted = await this.#terminal.ask(form);
 			const active = this.#active;
 			if (active?.id !== id || active.stopped) return;
 			const rejected = await this.#post(id, submitted);
 			const posted = this.#active;
 			if (posted?.id !== id || posted.stopped || rejected === void 0) return;
-			values = submitted;
-			errors = rejected;
+			answers.replace(submitted, rejected);
 			form.destroy();
 			this.#active = void 0;
 		}
 	}
+	#next() {
+		for (const entry of this.#queue) return entry;
+	}
 	#createRenderingForm(schema, values) {
 		const fields = schema.fields.map((field) => {
 			if (field.rule?.pattern === void 0) return field;
@@ -1784,8 +1801,7 @@ var PromptClient = class {
 		};
 	}
 };
-//#endregion
-//#region src/core/TerminalManager.ts
+// src/core/TerminalManager.ts
 /**
 * Registers named {@link PromptInterface} brokers, one per endpoint, so several parties can `ask`
 * forms of each other by name with a `from` → `to` attribution edge on every parked form, and
@@ -1951,11 +1967,7 @@ var TerminalManager = class {
 			for (const name of [...this.#terminals.keys()]) this.#removeOne(name);
 			return;
 		}
-		if (isArray(names)) {
-			let removed = true;
-			for (const name of names) if (!this.#removeOne(name)) removed = false;
-			return removed;
-		}
+		if (isArray(names)) return Iterator.from(names).reduce((result, name) => this.#removeOne(name) && result, true);
 		return this.#removeOne(names);
 	}
 	destroy() {
@@ -2027,8 +2039,7 @@ var TerminalManager = class {
 		}
 	}
 };
-//#endregion
-//#region src/core/stores/MemoryTerminalStore.ts
+// src/core/stores/MemoryTerminalStore.ts
 /**
 * Implements the in-memory {@link TerminalStoreInterface} — a process-lifetime `Map` of
 * {@link TerminalSnapshot} records keyed by endpoint id, the default store
@@ -2094,8 +2105,7 @@ var MemoryTerminalStore = class {
 		return Promise.resolve();
 	}
 };
-//#endregion
-//#region src/core/stores/DatabaseTerminalStore.ts
+// src/core/stores/DatabaseTerminalStore.ts
 /**
 * Implements a {@link TerminalStoreInterface} backed by one table of the `databases` layer — an
 * endpoint's durable config state is a row, so persistence reduces to keyed point-access (`get` /
@@ -2186,8 +2196,7 @@ var DatabaseTerminalStore = class {
 		await this.#table.remove(id);
 	}
 };
-//#endregion
-//#region src/core/factories.ts
+// src/core/factories.ts
 /**
 * Creates the headless {@link PromptInterface} broker. It parks live forms and applies remote
 * answers to the authoritative instances.
@@ -2302,7 +2311,6 @@ function createDatabaseTerminalStore(driver = createMemoryDriver()) {
 		tables: { terminals: columns }
 	}).table("terminals"));
 }
-//#endregion
 export { ACCEPT_EVENT_STREAM, BACKSPACE, CONTROL_NAMES, CTRL_A, CTRL_C, CTRL_D, CTRL_E, CTRL_U, DEFAULT_MASK, DEFAULT_PROMPT_THEME, DEFAULT_PROMPT_TIMEOUT_MS, DEFAULT_RECONNECT_DELAY_MS, DELETE, DatabaseTerminalStore, HEADER_TOKEN, KEY_SS3, MemoryTerminalStore, NEWLINE, PROMPT_ICONS, PROMPT_ROLES, Prompt, PromptClient, RETURN, SEQUENCE_NAMES, SPACE, SSE_BUFFER_LIMIT, SSE_EVENTS, TAB, TerminalError, TerminalManager, createCheckboxState, createConfirmState, createDatabaseTerminalStore, createEditorState, createInputState, createMemoryTerminalStore, createPasswordState, createPrompt, createPromptClient, createPromptTheme, createSelectState, createTerminalManager, defaultTimer, editLine, globalFetch, isAbortError, isInsecureRemote, isPendingForm, isPendingFormStatus, isPrintable, isTerminalError, isTerminalSnapshot, isWireEvent, parseKey, reduceCheckbox, reduceConfirm, reduceEditor, reduceInput, reducePassword, reduceSelect, renderCheckboxView, renderConfirmView, renderEditorView, renderErrorLine, renderHintedHeader, renderInputView, renderPasswordView, renderPromptHeader, renderSelectView, renderSubmitHeader, sanitizeDisplayText, sanitizeSchema, sanitizeThemeIcons, serializeDestroy, serializeExpire, serializePending, toggleIndex };
 
 //# sourceMappingURL=index.js.map