@nan0web/ui 1.0.1 → 1.0.3

package/types/core/InputAdapter.d.ts

@@ -1,11 +1,13 @@
-export default InputAdapter;
 /**
  * Abstract input adapter for UI implementations.
  *
  * @class InputAdapter
  * @extends Event
  */
-declare class InputAdapter extends Event {
+export default class InputAdapter extends Event {
+    static CancelError: typeof CancelError;
+    /** @returns {typeof CancelError} */
+    get CancelError(): typeof CancelError;
     /**
      * Starts listening for input and emits an `input` event.
      *
@@ -24,5 +26,21 @@ declare class InputAdapter extends Event {
      * @returns {boolean} Always true in base class.
      */
     isReady(): boolean;
+    /**
+     * Helper to ask a question.
+     * @param {string} question - Question to ask.
+     * @returns {Promise<string>}
+     */
+    ask(question: string): Promise<string>;
+    /**
+     * Generic selection prompt.
+     * @param {Object} config - Selection configuration.
+     * @returns {Promise<{ index: number, value: string | null }>}
+     */
+    select(config: any): Promise<{
+        index: number;
+        value: string | null;
+    }>;
 }
 import Event from "@nan0web/event/oop";
+import CancelError from "./Error/CancelError.js";

package/types/core/Message/InputMessage.d.ts

@@ -1,4 +1,4 @@
-/** @typedef {Message | string | null} InputMessageValue */
+/** @typedef {Partial<Message> | null} InputMessageValue */
 /**
  * Represents a message input with value, options, and metadata.
  */
@@ -13,7 +13,7 @@ export default class InputMessage {
     /**
      * Creates a new InputMessage instance.
      * @param {object} props - Input message properties
-     * @param {InputMessageValue} [props.value=""] - Input value
+     * @param {InputMessageValue} [props.value=null] - Input value
      * @param {string[]|string} [props.options=[]] - Available options
      * @param {boolean} [props.waiting=false] - Waiting state flag
      * @param {boolean} [props.escaped=false] - Sets value to escape when true
@@ -24,8 +24,8 @@ export default class InputMessage {
         waiting?: boolean | undefined;
         escaped?: boolean | undefined;
     });
-    /** @type {InputMessageValue} Input value */
-    value: InputMessageValue;
+    /** @type {Message} Input value */
+    value: Message;
     /** @type {string[]} Available options for this input */
     options: string[];
     /** @type {boolean} Whether this input is waiting for response */
@@ -67,5 +67,5 @@ export default class InputMessage {
     toString(): string;
     #private;
 }
-export type InputMessageValue = Message | string | null;
+export type InputMessageValue = Partial<Message> | null;
 import { Message } from "@nan0web/co";

package/types/core/Message/OutputMessage.d.ts

@@ -27,7 +27,7 @@ export default class OutputMessage extends UIMessage {
     /** @type {number} */
     priority: number;
     /** @param {string[]|string} value */
-    set content(arg: string[]);
+    set content(value: string[] | string);
     /** @returns {string[]} */
     get content(): string[];
     /** @returns {number} */

package/types/core/Stream.d.ts

@@ -22,6 +22,6 @@ export default class UIStream {
      * @param {Function} [onComplete] - Called with (item) when done.
      * @returns {Promise<void>}
      */
-    static process(signal: AbortSignal, generator: Function, onProgress?: Function | undefined, onError?: Function | undefined, onComplete?: Function | undefined): Promise<void>;
+    static process(signal: AbortSignal, generator: Function, onProgress?: Function, onError?: Function, onComplete?: Function): Promise<void>;
 }
 import StreamEntry from "./StreamEntry.js";

package/types/core/StreamEntry.d.ts

@@ -21,7 +21,7 @@ export default class StreamEntry {
         done?: boolean | undefined;
         cancelled?: boolean | undefined;
         error?: string | undefined;
-    } | undefined);
+    });
     /**
      * The value of the stream entry.
      * @type {any}

package/types/core/index.d.ts

@@ -7,3 +7,4 @@ export { default as OutputMessage } from "./Message/OutputMessage.js";
 export { default as FormMessage } from "./Form/Message.js";
 export { default as FormInput } from "./Form/Input.js";
 export { default as UIForm } from "./Form/Form.js";
+export { default as Error, CancelError } from "./Error/index.js";

package/types/index.d.ts

@@ -18,3 +18,4 @@ import Model from "./Model/index.js";
 import Component from "./Component/index.js";
 import App from "./App/index.js";
 export { Frame, FrameProps, Locale, StdIn, StdOut, View, RenderOptions, Model, Component, App };
+export { default as Error, CancelError } from "./core/Error/index.js";

package/src/App/Command/Options.js

@@ -1,78 +0,0 @@
-/**
- * Represents command options with default values.
- * Provides utilities for handling command line options.
- */
-class CommandOptions {
-	/**
-	 * Default option values.
-	 * @type {object}
-	 * @property {boolean} help - Whether help is requested
-	 * @property {string} cwd - Current working directory
-	 */
-	static DEFAULTS = {
-		help: false,
-		cwd: "",
-	}
-
-	/** @type {boolean} Whether help is requested */
-	help
-
-	/** @type {string} Current working directory */
-	cwd
-
-	/**
-	 * Creates a new CommandOptions instance.
-	 * @param {object} props - The properties for command options
-	 * @param {boolean} [props.help=false] - Whether help is requested
-	 * @param {string} [props.cwd=""] - Current working directory
-	 */
-	constructor(props = {}) {
-		const {
-			help = CommandOptions.DEFAULTS.help,
-			cwd = CommandOptions.DEFAULTS.cwd,
-		} = props
-		this.help = Boolean(help)
-		this.cwd = String(cwd)
-	}
-
-	/** @type {Record<string, any>} */
-	get DEFAULTS() {
-		return /** @type {typeof CommandOptions} */ (this.constructor).DEFAULTS
-	}
-
-	/**
-	 * Checks if all options have their default values.
-	 * @returns {boolean} True if all options are at their default values, false otherwise
-	 */
-	get empty() {
-		return Object.entries(this).every(
-			([key, value]) => CommandOptions.DEFAULTS[key] === value
-		)
-	}
-
-	/**
-	 * Converts the options to a string representation.
-	 * @returns {string} String representation of the options or "<no options>" if none set
-	 */
-	toString() {
-		const opts = Object.entries(this).map(([key, value]) => {
-			if (this.DEFAULTS[key] === value) return false
-			const prefix = true === value ? "--" : "-"
-			return `${prefix}${key}${value ? ` ${value}` : ""}`
-		}).filter(Boolean)
-		if (0 === opts.length) return "<no options>"
-		return opts.join(" ")
-	}
-
-	/**
-	 * Creates a CommandOptions instance from the given props.
-	 * @param {CommandOptions|object} props - The properties to create from
-	 * @returns {CommandOptions} A CommandOptions instance
-	 */
-	static from(props) {
-		if (props instanceof CommandOptions) return props
-		return new this(props)
-	}
-}
-
-export default CommandOptions

package/src/App/Command/index.js

@@ -1,9 +0,0 @@
-import { CommandMessage } from "@nan0web/co"
-import CommandOptions from "./Options.js"
-
-export { CommandMessage, CommandOptions }
-
-export default {
-	Message: CommandMessage,
-	Options: CommandOptions,
-}