@nan0web/ui 1.10.0 → 1.11.0

package/types/Model/index.d.ts

@@ -1,64 +1,58 @@
-export { User };
-export const HeaderModel: typeof DomainModels.HeaderModel;
-export const FooterModel: typeof DomainModels.FooterModel;
-export const HeroModel: typeof DomainModels.HeroModel;
-export const ButtonModel: typeof DomainModels.ButtonModel;
-export const ConfirmModel: typeof DomainModels.ConfirmModel;
-export const InputModel: typeof DomainModels.InputModel;
-export const SpinnerModel: typeof DomainModels.SpinnerModel;
-export const TableModel: typeof DomainModels.TableModel;
-export const ToastModel: typeof DomainModels.ToastModel;
-export const SelectModel: typeof DomainModels.SelectModel;
-export const AutocompleteModel: typeof DomainModels.AutocompleteModel;
-export const TreeModel: typeof DomainModels.TreeModel;
-export const TabsModel: typeof DomainModels.TabsModel;
-export const AccordionModel: typeof DomainModels.AccordionModel;
-export const GalleryModel: typeof DomainModels.GalleryModel;
-export const PriceModel: typeof DomainModels.PriceModel;
-export const PricingModel: typeof DomainModels.PricingModel;
-export const CommentModel: typeof DomainModels.CommentModel;
-export const TestimonialModel: typeof DomainModels.TestimonialModel;
-export const StatsItemModel: typeof DomainModels.StatsItemModel;
-export const StatsModel: typeof DomainModels.StatsModel;
-export const TimelineItemModel: typeof DomainModels.TimelineItemModel;
-export const TimelineModel: typeof DomainModels.TimelineModel;
 export default Model;
 import User from './User/User.js';
-import * as DomainModels from '../domain/index.js';
-declare const Model: {
-    SandboxModel: typeof DomainModels.SandboxModel;
-    ShowcaseAppModel: typeof DomainModels.ShowcaseAppModel;
-    Navigation: typeof DomainModels.Navigation;
-    Language: any;
-    HeaderModel: typeof DomainModels.HeaderModel;
-    FooterModel: typeof DomainModels.FooterModel;
-    HeroModel: typeof DomainModels.HeroModel;
-    ButtonModel: typeof DomainModels.ButtonModel;
-    ConfirmModel: typeof DomainModels.ConfirmModel;
-    InputModel: typeof DomainModels.InputModel;
-    SpinnerModel: typeof DomainModels.SpinnerModel;
-    TableModel: typeof DomainModels.TableModel;
-    ToastModel: typeof DomainModels.ToastModel;
-    SelectModel: typeof DomainModels.SelectModel;
-    AutocompleteModel: typeof DomainModels.AutocompleteModel;
-    TreeModel: typeof DomainModels.TreeModel;
-    TabsModel: typeof DomainModels.TabsModel;
-    AccordionModel: typeof DomainModels.AccordionModel;
-    GalleryModel: typeof DomainModels.GalleryModel;
-    PriceModel: typeof DomainModels.PriceModel;
-    PricingModel: typeof DomainModels.PricingModel;
-    CommentModel: typeof DomainModels.CommentModel;
-    TestimonialModel: typeof DomainModels.TestimonialModel;
-    StatsItemModel: typeof DomainModels.StatsItemModel;
-    StatsModel: typeof DomainModels.StatsModel;
-    TimelineItemModel: typeof DomainModels.TimelineItemModel;
-    TimelineModel: typeof DomainModels.TimelineModel;
-    HeaderVisibilityModel: typeof DomainModels.HeaderVisibilityModel;
-    HeaderConfigModel: typeof DomainModels.HeaderConfigModel;
-    FooterVisibilityModel: typeof DomainModels.FooterVisibilityModel;
-    FooterConfigModel: typeof DomainModels.FooterConfigModel;
-    EmptyStateModel: typeof DomainModels.EmptyStateModel;
-    BannerModel: typeof DomainModels.BannerModel;
-    ProfileDropdownModel: typeof DomainModels.ProfileDropdownModel;
-    User: typeof User;
-};
+import { HeaderModel } from '../domain/HeaderModel.js';
+import { FooterModel } from '../domain/FooterModel.js';
+import { HeroModel } from '../domain/HeroModel.js';
+import { ButtonModel } from '../domain/components/index.js';
+import { ConfirmModel } from '../domain/components/index.js';
+import { InputModel } from '../domain/components/index.js';
+import { SpinnerModel } from '../domain/components/index.js';
+import { TableModel } from '../domain/components/index.js';
+import { ToastModel } from '../domain/components/index.js';
+import { SelectModel } from '../domain/components/index.js';
+import { AutocompleteModel } from '../domain/components/index.js';
+import { TreeModel } from '../domain/components/index.js';
+import { TabsModel } from '../domain/components/index.js';
+import { AccordionModel } from '../domain/components/index.js';
+import { GalleryModel } from '../domain/components/index.js';
+import { PriceModel } from '../domain/components/index.js';
+import { PricingModel } from '../domain/components/index.js';
+import { CommentModel } from '../domain/components/index.js';
+import { TestimonialModel } from '../domain/components/index.js';
+import { StatsItemModel } from '../domain/components/index.js';
+import { StatsModel } from '../domain/components/index.js';
+import { TimelineItemModel } from '../domain/components/index.js';
+import { TimelineModel } from '../domain/components/index.js';
+import { EmptyStateModel } from '../domain/components/index.js';
+import { BannerModel } from '../domain/components/index.js';
+import { ProfileDropdownModel } from '../domain/components/index.js';
+declare namespace Model {
+    export { User };
+    export { HeaderModel };
+    export { FooterModel };
+    export { HeroModel };
+    export { ButtonModel };
+    export { ConfirmModel };
+    export { InputModel };
+    export { SpinnerModel };
+    export { TableModel };
+    export { ToastModel };
+    export { SelectModel };
+    export { AutocompleteModel };
+    export { TreeModel };
+    export { TabsModel };
+    export { AccordionModel };
+    export { GalleryModel };
+    export { PriceModel };
+    export { PricingModel };
+    export { CommentModel };
+    export { TestimonialModel };
+    export { StatsItemModel };
+    export { StatsModel };
+    export { TimelineItemModel };
+    export { TimelineModel };
+    export { EmptyStateModel };
+    export { BannerModel };
+    export { ProfileDropdownModel };
+}
+export { User, HeaderModel, FooterModel, HeroModel, ButtonModel, ConfirmModel, InputModel, SpinnerModel, TableModel, ToastModel, SelectModel, AutocompleteModel, TreeModel, TabsModel, AccordionModel, GalleryModel, PriceModel, PricingModel, CommentModel, TestimonialModel, StatsItemModel, StatsModel, TimelineItemModel, TimelineModel, EmptyStateModel, BannerModel, ProfileDropdownModel };

package/types/StdIn.d.ts

@@ -22,10 +22,10 @@ export default class StdIn extends EventProcessor {
         processor?: Processor | undefined;
         stream?: UiMessage[] | undefined;
     });
-    /** @type {UiMessage[]} Input message buffer */
-    stream: UiMessage[];
     /** @type {Processor} Input processor */
     processor: Processor;
+    /** @type {UiMessage[]} Input message buffer */
+    stream: UiMessage[];
     /**
      * Checks if there are messages waiting in the input stream.
      * @returns {boolean} True if waiting messages, false otherwise
@@ -56,7 +56,7 @@ export default class StdIn extends EventProcessor {
     decode(message: UiMessage | string[] | any): UiMessage;
 }
 import EventProcessor from '@nan0web/event/oop';
-import { UiMessage } from './core/index.js';
 declare class Processor extends EventProcessor {
 }
+import { UiMessage } from './core/index.js';
 export {};

package/types/cli.d.ts

@@ -0,0 +1 @@
+export { UIApp as default } from "./domain/app/UIApp.js";

package/types/core/GeneratorRunner.d.ts

@@ -29,9 +29,17 @@ export type AdapterHandlers = {
      */
     progress?: ((intent: import("./Intent.js").ProgressIntent) => void | Promise<void>) | undefined;
     /**
-     * Handler for 'log' intents. Optional (defaults to no-op).
+     * Handler for 'show' intents. Optional (defaults to no-op).
+     */
+    show?: ((intent: import("./Intent.js").ShowIntent) => void | Promise<void>) | undefined;
+    /**
+     * Handler for 'log' intents. Optional.
      */
     log?: ((intent: import("./Intent.js").LogIntent) => void | Promise<void>) | undefined;
+    /**
+     * Handler for 'agent' intents (AI Subagents). Optional (fallback to show if not implemented).
+     */
+    agent?: ((intent: import("./Intent.js").AgentIntent) => Promise<import("./Intent.js").AgentResponse>) | undefined;
     /**
      * Handler for 'render' intents (visual component injection). Optional.
      */
@@ -52,4 +60,9 @@ export type RunnerOptions = {
      * External AbortSignal for cancellation from outside.
      */
     signal?: AbortSignal | undefined;
+    /**
+     * Array where all executed intents will be sequentially recorded.
+     * Useful for generating 'crash reports' or Nan0Spec files on failure.
+     */
+    trace?: import("./Intent.js").Intent[] | undefined;
 };

package/types/core/InputAdapter.d.ts

@@ -4,7 +4,7 @@
  * @class InputAdapter
  * @extends Event
  */
-export default class InputAdapter extends Event {
+export class InputAdapter extends Event {
     static CancelError: typeof CancelError;
     /** @returns {typeof CancelError} */
     get CancelError(): typeof CancelError;
@@ -42,5 +42,6 @@ export default class InputAdapter extends Event {
         value: string | null;
     }>;
 }
+export default InputAdapter;
 import Event from '@nan0web/event/oop';
 import CancelError from './Error/CancelError.js';

package/types/core/Intent.d.ts

@@ -12,6 +12,65 @@ export function isModelSchema(schema: any): boolean;
  * @returns {intent is Intent}
  */
 export function validateIntent(intent: any): intent is Intent;
+/**
+ * Create an ask intent.
+ *
+ * Two modes:
+ *   ask('amount', { help: 'Enter amount', type: 'number' })  → single field
+ *   ask('transfer', TransferMoneyModel)                       → full Model form
+ *
+ * @param {string} field - Field name or form name.
+ * @param {object | Function} schema - Field descriptor or Model-as-Schema class.
+ * @returns {AskIntent}
+ */
+export function ask(field: string, schema: object | Function): AskIntent;
+/**
+ * Create a progress intent.
+ * @param {string} message - Status message from Model (i18n static field value).
+ * @param {number} [value=0] - Progress value (current step or percentage).
+ * @param {number|string} [totalOrId] - Absolute total steps (number) OR progress tracking ID (string).
+ * @param {string} [id='default'] - Progress ID (if total is provided).
+ * @returns {ProgressIntent}
+ */
+export function progress(message: string, value?: number, totalOrId?: number | string, id?: string): ProgressIntent;
+export function log(level: any, message: any, data?: {}): {
+    type: string;
+    level: any;
+    message: any;
+};
+/**
+ * Create a render intent.
+ * @param {string} component - Component name (e.g. 'App.Layout.Header').
+ * @param {object} [props] - Static props for the component.
+ * @returns {RenderIntent}
+ */
+export function render(component: string, props?: object): RenderIntent;
+/**
+ * Create a result intent.
+ * @param {*} data - The raw result data.
+ * @returns {ResultIntent}
+ */
+export function result(data: any): ResultIntent;
+/**
+ * @typedef {Object} ShowData
+ * @property {any} [component]
+ * @property {import('@nan0web/types').Model} [model]
+ */
+/**
+ * Create a show intent.
+ * @param {string | any} message Message to display.
+ * @param {ShowLevel|ShowData} [level='info'] Level of message or additional data then `level = 'info'`.
+ * @param {ShowData} [data={}] Additional data to display.
+ * @returns {ShowIntent}
+ */
+export function show(message: string | any, level?: ShowLevel | ShowData, data?: ShowData): ShowIntent;
+/**
+ * Create an agent intent to delegate a task to an AI subagent.
+ * @param {string} task - The instructional task for the AI agent.
+ * @param {AgentContext} [context={}] - Contextual data (files, errors, docs).
+ * @returns {AgentIntent}
+ */
+export function agent(task: string, context?: AgentContext): AgentIntent;
 /**
  * @typedef {Object} FieldSchema
  * @property {string} help - Human-readable label / i18n key.
@@ -36,16 +95,28 @@ export function validateIntent(intent: any): intent is Intent;
  * @typedef {Object} ProgressIntent
  * @property {'progress'} type
  * @property {number} [value] - Progress value (0-1).
- * @property {string} [id] - Progress ID for tracking multiple parallel operations.
+ * @property {number} [total] - Absolute total (if value is absolute).
+ * @property {string} [id] - Progress ID for tracking by Adapter to calculate speed/eta.
  * @property {string} message - Status message from Model (i18n static field value).
  */
 /**
- * Model emits a log message. No response expected.
+ * @typedef {'info' | 'warn' | 'error' | 'success'} ShowLevel
+ */
+/** @typedef {ShowLevel} LogLevel */
+/**
+ * Model emits a show message. No response expected.
  * Message MUST come from the Model (i18n static field value).
+ * @typedef {Object} ShowIntent
+ * @property {'show'} type
+ * @property {ShowLevel} level
+ * @property {string} message - Show message from Model (i18n static field value).
+ */
+/**
+ * Model emits a log message intended for debugging/developer (Not UI).
  * @typedef {Object} LogIntent
  * @property {'log'} type
- * @property {'info' | 'warn' | 'error' | 'success'} level
- * @property {string} message - Log message from Model (i18n static field value).
+ * @property {LogLevel} level
+ * @property {string} message - Internal log message.
  */
 /**
  * Final return value from the generator.
@@ -61,9 +132,31 @@ export function validateIntent(intent: any): intent is Intent;
  * @property {string} component - Component name (e.g. 'App.Layout.Header').
  * @property {object} props - Static props for the component.
  */
+/**
+ * Contextual data and attachments for the AI subagent.
+ * @typedef {Object} AgentContext
+ * @property {string[]} [instructions] - List of instructions or guidelines (e.g. ['Use 1-char emojis only']).
+ * @property {Record<string, string>} [files] - Hash map of file paths to their string contents.
+ * @property {Record<string, any>} [data] - Any arbitrary JSON data (e.g. parsed errors, ASTs, metadata) useful for the task.
+ */
+/**
+ * Model delegates a task to an AI subagent. The Adapter should launch the agent
+ * with the provided task and context, and return the result. If the agent is skipped,
+ * it returns { success: false } but allows user to generate a prompt.
+ * @typedef {Object} AgentIntent
+ * @property {'agent'} type
+ * @property {string} task - The instructional task for the AI agent.
+ * @property {AgentContext} context - Contextual data, files, and instructions for the task.
+ * @property {() => string} toPrompt - Helper to format task and context as an LLM prompt.
+ */
 /**
  * Union of all possible yielded intents.
- * @typedef {AskIntent | ProgressIntent | LogIntent | RenderIntent} Intent
+ * @typedef {(AskIntent | ProgressIntent | LogIntent | ShowIntent | RenderIntent | AgentIntent | ResultIntent) & {
+ *   $value?: any;
+ *   $success?: boolean;
+ *   $files?: Record<string, string>;
+ *   $message?: string;
+ * }} Intent
  */
 /**
  * Response to an AskIntent. Adapter provides the collected value.
@@ -72,6 +165,20 @@ export function validateIntent(intent: any): intent is Intent;
  * @property {*} value - The value matching schema.type (collected from user / LLM / test fixture).
  * @property {boolean} [cancelled] - Whether the user cancelled this interaction (e.g. pressed ESC).
  */
+/**
+ * Response to an AgentIntent.
+ * The underlying Adapter (Orchestrator) is responsible for communicating with the LLM,
+ * enforcing output formats (e.g. Unified Diff or Tool Calls like `updateFile`),
+ * and resolving common LLM hallucinations (like Grok truncating code with `// ...`).
+ *
+ * The Model (e.g. IconsAuditor) receives this clean, resolved response and does not
+ * need to parse Markdown or interpret diffs itself.
+ *
+ * @typedef {Object} AgentResponse
+ * @property {boolean} success - True if the agent successfully processed the task.
+ * @property {Record<string, string>} [files] - Hash map of fully resolved, updated file contents.
+ * @property {string} [message] - Optional summary or explanation returned by the AI.
+ */
 /**
  * Special response that Adapters can send to abort the generator.
  *
@@ -88,27 +195,15 @@ export function validateIntent(intent: any): intent is Intent;
  */
 /**
  * Union of all possible responses an Adapter can send back via iterator.next().
- * @typedef {AskResponse | AbortResponse | undefined} IntentResponse
+ * @typedef {AskResponse | AgentResponse | AbortResponse | undefined} IntentResponse
  */
-export const INTENT_TYPES: readonly ["ask", "progress", "log", "render"];
-export function ask(field: string, schema: object | Function): AskIntent;
-export function progress(message: any): {
-    type: string;
-    message: any;
-};
-export function log(level: any, message: any, data?: {}): {
-    type: string;
-    level: any;
-    message: any;
-};
-export function render(component: any, props?: {}): {
-    type: string;
-    component: any;
-    props: {};
-};
-export function result(data: any): {
-    type: string;
-    data: any;
+/**
+ * @typedef {'ask' | 'show' | 'progress' | 'render' | 'agent'} IntentType
+ */
+export const INTENT_TYPES: readonly ["ask", "progress", "show", "log", "render", "agent"];
+export type ShowData = {
+    component?: any;
+    model?: import("@nan0web/types").Model | undefined;
 };
 export type FieldSchema = {
     /**
@@ -169,7 +264,11 @@ export type ProgressIntent = {
      */
     value?: number | undefined;
     /**
-     * - Progress ID for tracking multiple parallel operations.
+     * - Absolute total (if value is absolute).
+     */
+    total?: number | undefined;
+    /**
+     * - Progress ID for tracking by Adapter to calculate speed/eta.
      */
     id?: string | undefined;
     /**
@@ -177,15 +276,28 @@ export type ProgressIntent = {
      */
     message: string;
 };
+export type ShowLevel = "info" | "warn" | "error" | "success";
+export type LogLevel = ShowLevel;
 /**
- * Model emits a log message. No response expected.
+ * Model emits a show message. No response expected.
  * Message MUST come from the Model (i18n static field value).
  */
+export type ShowIntent = {
+    type: "show";
+    level: ShowLevel;
+    /**
+     * - Show message from Model (i18n static field value).
+     */
+    message: string;
+};
+/**
+ * Model emits a log message intended for debugging/developer (Not UI).
+ */
 export type LogIntent = {
     type: "log";
-    level: "info" | "warn" | "error" | "success";
+    level: LogLevel;
     /**
-     * - Log message from Model (i18n static field value).
+     * - Internal log message.
      */
     message: string;
 };
@@ -214,10 +326,52 @@ export type RenderIntent = {
      */
     props: object;
 };
+/**
+ * Contextual data and attachments for the AI subagent.
+ */
+export type AgentContext = {
+    /**
+     * - List of instructions or guidelines (e.g. ['Use 1-char emojis only']).
+     */
+    instructions?: string[] | undefined;
+    /**
+     * - Hash map of file paths to their string contents.
+     */
+    files?: Record<string, string> | undefined;
+    /**
+     * - Any arbitrary JSON data (e.g. parsed errors, ASTs, metadata) useful for the task.
+     */
+    data?: Record<string, any> | undefined;
+};
+/**
+ * Model delegates a task to an AI subagent. The Adapter should launch the agent
+ * with the provided task and context, and return the result. If the agent is skipped,
+ * it returns { success: false } but allows user to generate a prompt.
+ */
+export type AgentIntent = {
+    type: "agent";
+    /**
+     * - The instructional task for the AI agent.
+     */
+    task: string;
+    /**
+     * - Contextual data, files, and instructions for the task.
+     */
+    context: AgentContext;
+    /**
+     * - Helper to format task and context as an LLM prompt.
+     */
+    toPrompt: () => string;
+};
 /**
  * Union of all possible yielded intents.
  */
-export type Intent = AskIntent | ProgressIntent | LogIntent | RenderIntent;
+export type Intent = (AskIntent | ProgressIntent | LogIntent | ShowIntent | RenderIntent | AgentIntent | ResultIntent) & {
+    $value?: any;
+    $success?: boolean;
+    $files?: Record<string, string>;
+    $message?: string;
+};
 /**
  * Response to an AskIntent. Adapter provides the collected value.
  * The value MUST conform to the type described in the requested FieldSchema.
@@ -232,6 +386,29 @@ export type AskResponse = {
      */
     cancelled?: boolean | undefined;
 };
+/**
+ * Response to an AgentIntent.
+ * The underlying Adapter (Orchestrator) is responsible for communicating with the LLM,
+ * enforcing output formats (e.g. Unified Diff or Tool Calls like `updateFile`),
+ * and resolving common LLM hallucinations (like Grok truncating code with `// ...`).
+ *
+ * The Model (e.g. IconsAuditor) receives this clean, resolved response and does not
+ * need to parse Markdown or interpret diffs itself.
+ */
+export type AgentResponse = {
+    /**
+     * - True if the agent successfully processed the task.
+     */
+    success: boolean;
+    /**
+     * - Hash map of fully resolved, updated file contents.
+     */
+    files?: Record<string, string> | undefined;
+    /**
+     * - Optional summary or explanation returned by the AI.
+     */
+    message?: string | undefined;
+};
 /**
  * Special response that Adapters can send to abort the generator.
  *
@@ -255,4 +432,5 @@ export type AbortResponse = {
 /**
  * Union of all possible responses an Adapter can send back via iterator.next().
  */
-export type IntentResponse = AskResponse | AbortResponse | undefined;
+export type IntentResponse = AskResponse | AgentResponse | AbortResponse | undefined;
+export type IntentType = "ask" | "show" | "progress" | "render" | "agent";

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

@@ -61,9 +61,9 @@ export default class UiMessage extends Message {
      */
     constructor(input?: any);
     /** @type {string} */
-    type: string;
-    /** @type {string} */
     id: string;
+    /** @type {string} */
+    type: string;
     /**
      * Validates the message body against its schema.
      *

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

@@ -18,8 +18,6 @@ export default class OutputMessage extends UiMessage {
      * @returns {OutputMessage}
      */
     static from(input: any): OutputMessage;
-    /** @type {string[]} */
-    body: string[];
     /** @type {Object} */
     meta: any;
     /** @type {Error|null} */

package/types/core/index.d.ts

@@ -7,6 +7,7 @@ export { default as UiAdapter } from "./UiAdapter.js";
 export { IntentErrorModel } from "./IntentErrorModel.js";
 export { runGenerator } from "./GeneratorRunner.js";
 export { MaskHandler } from "./MaskHandler.js";
+export { LayoutModel } from "../domain/LayoutModel.js";
 import UIStream from './Stream.js';
 import StreamEntry from './StreamEntry.js';
 import UIForm from './Form/Form.js';