@nan0web/ui 1.0.4 → 1.3.0

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

@@ -3,69 +3,69 @@
  * Represents a message input with value, options, and metadata.
  */
 export default class InputMessage {
-    static ESCAPE: string;
-    /**
-     * Creates an InputMessage instance from the given value.
-     * @param {InputMessage|object|string} value - The value to create from
-     * @returns {InputMessage} An InputMessage instance
-     */
-    static from(value: InputMessage | object | string): InputMessage;
-    /**
-     * Creates a new InputMessage instance.
-     * @param {object} props - Input message properties
-     * @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
-     */
-    constructor(props?: {
-        value?: InputMessageValue | undefined;
-        options?: string | string[] | undefined;
-        waiting?: boolean | undefined;
-        escaped?: boolean | undefined;
-    });
-    /** @type {Message} Input value */
-    value: Message;
-    /** @type {string[]} Available options for this input */
-    options: string[];
-    /** @type {boolean} Whether this input is waiting for response */
-    waiting: boolean;
-    /**
-     * Checks if the input value is empty.
-     * @returns {boolean} True if value is empty or null, false otherwise
-     */
-    get empty(): boolean;
-    /**
-     * Gets the timestamp when input was created.
-     * @returns {number} Creation timestamp
-     */
-    get time(): number;
-    /**
-     * Returns the escape value.
-     * @returns {string}
-     */
-    get ESCAPE(): string;
-    /**
-     * Checks if the input is an escape sequence.
-     * @returns {boolean} True if input value is escape sequence, false otherwise
-     */
-    get escaped(): boolean;
-    /**
-     * Validates if the input has a non-empty value.
-     * @returns {boolean} True if input is valid, false otherwise
-     */
-    get isValid(): boolean;
-    /**
-     * Converts the input to a plain object representation.
-     * @returns {object} Object with all properties including timestamp
-     */
-    toObject(): object;
-    /**
-     * Converts the input to a string representation including timestamp.
-     * @returns {string} String representation with timestamp and value
-     */
-    toString(): string;
-    #private;
+	static ESCAPE: string
+	/**
+	 * Creates an InputMessage instance from the given value.
+	 * @param {InputMessage|object|string} value - The value to create from
+	 * @returns {InputMessage} An InputMessage instance
+	 */
+	static from(value: InputMessage | object | string): InputMessage
+	/**
+	 * Creates a new InputMessage instance.
+	 * @param {object} props - Input message properties
+	 * @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
+	 */
+	constructor(props?: {
+		value?: InputMessageValue | undefined
+		options?: string | string[] | undefined
+		waiting?: boolean | undefined
+		escaped?: boolean | undefined
+	})
+	/** @type {Message} Input value */
+	value: Message
+	/** @type {string[]} Available options for this input */
+	options: string[]
+	/** @type {boolean} Whether this input is waiting for response */
+	waiting: boolean
+	/**
+	 * Checks if the input value is empty.
+	 * @returns {boolean} True if value is empty or null, false otherwise
+	 */
+	get empty(): boolean
+	/**
+	 * Gets the timestamp when input was created.
+	 * @returns {number} Creation timestamp
+	 */
+	get time(): number
+	/**
+	 * Returns the escape value.
+	 * @returns {string}
+	 */
+	get ESCAPE(): string
+	/**
+	 * Checks if the input is an escape sequence.
+	 * @returns {boolean} True if input value is escape sequence, false otherwise
+	 */
+	get escaped(): boolean
+	/**
+	 * Validates if the input has a non-empty value.
+	 * @returns {boolean} True if input is valid, false otherwise
+	 */
+	get isValid(): boolean
+	/**
+	 * Converts the input to a plain object representation.
+	 * @returns {object} Object with all properties including timestamp
+	 */
+	toObject(): object
+	/**
+	 * Converts the input to a string representation including timestamp.
+	 * @returns {string} String representation with timestamp and value
+	 */
+	toString(): string
+	#private
 }
-export type InputMessageValue = Partial<Message> | null;
-import { Message } from "@nan0web/co";
+export type InputMessageValue = Partial<Message> | null
+import { Message } from '@nan0web/co'

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

@@ -90,4 +90,4 @@ export type MessageBodySchema = {
     defaultValue?: any;
     validate?: Function | undefined;
 };
-import { Message } from "@nan0web/co";
+import { Message } from '@nan0web/co';

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

@@ -50,4 +50,4 @@ export default class OutputMessage extends UiMessage {
      */
     toJSON(): any;
 }
-import UiMessage from "./Message.js";
+import UiMessage from './Message.js';

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

@@ -1,4 +1,4 @@
 export default UiMessage;
-import UiMessage from "./Message.js";
-import OutputMessage from "./OutputMessage.js";
+import UiMessage from './Message.js';
+import OutputMessage from './OutputMessage.js';
 export { UiMessage, OutputMessage };

package/types/core/Stream.d.ts

@@ -1,4 +1,3 @@
-export { StreamEntry };
 /**
  * Agnostic UI stream for processing progress using async generators.
  *
@@ -25,4 +24,4 @@ export default class UIStream {
      */
     static process(signal: AbortSignal, generatorFn: () => AsyncGenerator<StreamEntry>, onProgress?: Function, onError?: Function, onComplete?: Function): Promise<void>;
 }
-import StreamEntry from "./StreamEntry.js";
+import StreamEntry from './StreamEntry.js';

package/types/core/UiAdapter.d.ts

@@ -74,6 +74,23 @@ export default class UiAdapter extends EventProcessor {
         index: number;
         value: string | null;
     }>;
+    /**
+     * Process a UIForm and return its result.
+     *
+     * This default implementation follows an **agnostic UI** approach:
+     * it simply returns the form instance (with optional initial state merged)
+     * without UI interaction. Concrete adapters (CLI, Web, etc.) can override
+     * this method to render the form, collect user input and return a richer
+     * result object (`{ form, cancelled }`).
+     *
+     * @param {UIForm} form - The UIForm instance to process.
+     * @param {object} [initialState={}] - Pre‑filled values for the form.
+     * @returns {Promise<{ form: UIForm, cancelled?: boolean }>} Form processing result.
+     */
+    processForm(form: UIForm, initialState?: object): Promise<{
+        form: UIForm;
+        cancelled?: boolean;
+    }>;
     /**
      * Ensures a message's body is fully and validly filled.
      * Generates a form from the message's static Body schema,
@@ -98,7 +115,8 @@ export default class UiAdapter extends EventProcessor {
      */
     render(message: UIMessage): void;
 }
-import UIForm from "./Form/Form.js";
-import EventProcessor from "@nan0web/event/oop";
-import CancelError from "./Error/CancelError.js";
-import UIMessage from "./Message/Message.js";
+import UIForm from './Form/Form.js';
+import EventProcessor from '@nan0web/event/oop';
+import CancelError from './Error/CancelError.js';
+import OutputAdapter from './OutputAdapter.js';
+import UIMessage from './Message/Message.js';

package/types/core/index.d.ts

@@ -1,9 +1,12 @@
 export { default as InputAdapter } from "./InputAdapter.js";
 export { default as OutputAdapter } from "./OutputAdapter.js";
-export { default as UIStream } from "./Stream.js";
 export { default as UiMessage } from "./Message/Message.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 UiAdapter } from "./UiAdapter.js";
+import UIStream from './Stream.js';
+import StreamEntry from './StreamEntry.js';
+import UIForm from './Form/Form.js';
+export { UIStream, UIStream as UiStream, StreamEntry, StreamEntry as UiStreamEntry, UIForm, UIForm as UiForm };
 export { default as Error, CancelError } from "./Error/index.js";
+export { runFlow, flow, View, Prompt, Stream, Alert, Toast, Badge, Text, Table, Input, Select, Confirm, Multiselect, Mask, Password, Spinner, Progress, default as Flow } from "./Flow.js";

package/types/index.d.ts

@@ -7,15 +7,15 @@ export { default as UiForm } from "./core/Form/Form.js";
 export { default as UiMessage } from "./core/Message/Message.js";
 export { default as UiStream } from "./core/Stream.js";
 export { default as UiAdapter } from "./core/UiAdapter.js";
-import Frame from "./Frame/Frame.js";
-import FrameProps from "./Frame/Props.js";
-import Locale from "./Locale.js";
-import StdIn from "./StdIn.js";
-import StdOut from "./StdOut.js";
-import View from "./View/View.js";
-import RenderOptions from "./View/RenderOptions.js";
-import Model from "./Model/index.js";
-import Component from "./Component/index.js";
-import App from "./App/index.js";
+import Frame from './Frame/Frame.js';
+import FrameProps from './Frame/Props.js';
+import Locale from './Locale.js';
+import StdIn from './StdIn.js';
+import StdOut from './StdOut.js';
+import View from './View/View.js';
+import RenderOptions from './View/RenderOptions.js';
+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";