@nan0web/ui 1.12.3 → 3.1.0

package/types/core/index.d.ts

@@ -1,14 +1,17 @@
 export { default as InputAdapter } from "./InputAdapter.js";
 export { default as OutputAdapter } from "./OutputAdapter.js";
+export { default as FormInput } from "./Form/Input.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 UiAdapter } from "./UiAdapter.js";
+export { default as OutputMessage } from "./Message/OutputMessage.js";
 export { IntentErrorModel } from "./IntentErrorModel.js";
 export { runGenerator } from "./GeneratorRunner.js";
 export { MaskHandler } from "./MaskHandler.js";
 export { LayoutModel } from "../domain/LayoutModel.js";
 export type Intent = import("./Intent.js").Intent;
+export type ShowLevel = import("./Intent.js").ShowLevel;
+export type ShowIntent = import("./Intent.js").ShowIntent;
+export type ShowData = import("./Intent.js").ShowData;
 export type AskResponse = import("./Intent.js").AskResponse;
 export type AskOptions = import("./InputAdapter.js").AskOptions;
 import UIStream from './Stream.js';

package/types/domain/Document.d.ts

@@ -20,7 +20,7 @@ export class Document extends Model {
     };
     static langs: {
         type: string;
-        model: any;
+        model: typeof Language;
         help: string;
     };
     /**
@@ -38,3 +38,4 @@ export class Document extends Model {
 import { Model } from '@nan0web/types';
 import { Content } from './Content.js';
 import Navigation from './Navigation.js';
+import { Language } from '@nan0web/i18n';

package/types/domain/FooterModel.d.ts

@@ -38,7 +38,7 @@ export class FooterModel extends Model {
     static langs: {
         help: string;
         type: string;
-        hint: any;
+        hint: typeof Language;
         default: never[];
     };
     /**
@@ -60,3 +60,4 @@ export class FooterModel extends Model {
 }
 import { Model } from '@nan0web/types';
 import Navigation from './Navigation.js';
+import { Language } from '@nan0web/i18n';

package/types/domain/ModelAsApp.d.ts

@@ -33,7 +33,7 @@ export class ModelAsApp extends Model {
         _isExplicit: boolean;
         db: import("@nan0web/db").default | null | undefined;
         plugins: Record<string, any>;
-        t: import("@nan0web/types/src/utils/TFunction").TFunction;
+        t: import("../../../types/types/utils/TFunction.js").TFunction;
     };
     /**
      * Instantiates a subcommand if the value matches one of the options.

package/types/domain/app/IntentAuditor.d.ts

@@ -0,0 +1,23 @@
+/**
+ * IntentAuditor — Base model for OLMUI Intent hygiene audits.
+ * Polymorphically delegates execution to JS or Python subclasses.
+ */
+export class IntentAuditor extends AuditorModel {
+    static UI: {
+        title: string;
+        description: string;
+        icon: string;
+        starting: string;
+        auditPassed: string;
+        auditFailed: string;
+        doneSuccess: string;
+        doneErrors: string;
+        errorDb: string;
+        errorConsoleLeak: string;
+        errorProcessLeak: string;
+        errorPrintLeak: string;
+        errorSysWriteLeak: string;
+    };
+}
+export default IntentAuditor;
+import { AuditorModel } from '@nan0web/inspect/domain/AuditorModel';

package/types/domain/app/JsIntentAuditor.d.ts

@@ -0,0 +1,22 @@
+/**
+ * JsIntentAuditor — Specialized auditor for JS/TS output hygiene.
+ */
+export class JsIntentAuditor extends AuditorModel {
+    /** @type {string[]} Directories to ignore during scanning */
+    static IGNORE_DIRS: string[];
+    /**
+     * Checks if a directory or file should be ignored.
+     * @param {string} name
+     * @returns {boolean}
+     */
+    static isIgnored(name: string): boolean;
+    /**
+     * Inspects file content for console.* or process.* writes.
+     * @param {string} content Content of the file.
+     * @param {import('@nan0web/i18n').TFunction} t Translate function.
+     * @returns {string[]} List of error messages.
+     */
+    static inspectFileContent(content: string, t: import("@nan0web/i18n").TFunction): string[];
+}
+export default JsIntentAuditor;
+import { AuditorModel } from '@nan0web/inspect/domain/AuditorModel';

package/types/domain/app/PyIntentAuditor.d.ts

@@ -0,0 +1,22 @@
+/**
+ * PyIntentAuditor — Specialized auditor for Python output hygiene.
+ */
+export class PyIntentAuditor extends AuditorModel {
+    /** @type {string[]} Directories to ignore during scanning */
+    static IGNORE_DIRS: string[];
+    /**
+     * Checks if a directory or file should be ignored.
+     * @param {string} name
+     * @returns {boolean}
+     */
+    static isIgnored(name: string): boolean;
+    /**
+     * Inspects Python file content for print or sys.stdout/stderr writes.
+     * @param {string} content Content of the file.
+     * @param {import('@nan0web/i18n').TFunction} t Translate function.
+     * @returns {string[]} List of error messages.
+     */
+    static inspectFileContent(content: string, t: import("@nan0web/i18n").TFunction): string[];
+}
+export default PyIntentAuditor;
+import { AuditorModel } from '@nan0web/inspect/domain/AuditorModel';

package/types/domain/app/SnapshotAuditor.d.ts

@@ -3,7 +3,6 @@
  * Parses snapshots without evaluating the app logic and detects artifacts.
  */
 export class SnapshotAuditor extends AuditorModel {
-    static alias: string;
     static data: {
         type: string;
         help: string;
@@ -56,11 +55,11 @@ export class SnapshotAuditor extends AuditorModel {
     static extractWords(obj: any, set: Set<string>): void;
     /**
      * Scans data directories to build a word set for each language.
-     * @param {import('@nan0web/db').DB} fsDb FileSystem DB.
+     * @param {any} fsDb FileSystem DB.
      * @param {string} data
      * @returns {Promise<Record<string, Set<string>>>}
      */
-    static buildDictionaries(fsDb: import("@nan0web/db").DB, data?: string): Promise<Record<string, Set<string>>>;
+    static buildDictionaries(fsDb: any, data?: string): Promise<Record<string, Set<string>>>;
     /**
      * Inspects a single snapshot text.
      * @param {string} content Content of the file.
@@ -70,7 +69,7 @@ export class SnapshotAuditor extends AuditorModel {
      * @param {Record<string, Set<string>>} [dictionaries=undefined] Loaded dictionaries for mutual exclusion check.
      * @returns {{ score: number, errors: string[] }}
      */
-    static inspectText(content: string, locale: string, filename: string, t: any, dictionaries?: Record<string, Set<string>>): {
+    static inspectText(content: string, locale: string, filename: string, t: import("@nan0web/i18n").TFunction, dictionaries?: Record<string, Set<string>>): {
         score: number;
         errors: string[];
     };
@@ -83,7 +82,7 @@ export class SnapshotAuditor extends AuditorModel {
     static checkNode(node: any, path: string, context: {
         locale: string;
         errors: string[];
-        t: any;
+        t: import("@nan0web/i18n").TFunction;
         dictionaries?: Record<string, Set<string>>;
     }): void;
     /**
@@ -95,7 +94,7 @@ export class SnapshotAuditor extends AuditorModel {
     static checkString(str: string, path: string, context: {
         locale: string;
         errors: string[];
-        t: any;
+        t: import("@nan0web/i18n").TFunction;
         dictionaries?: Record<string, Set<string>>;
     }): void;
     /**

package/types/domain/components/ShellModel.d.ts

@@ -46,11 +46,7 @@ export class ShellModel extends Model {
     /** @type {string} */ index: string;
     /** @type {string} */ locale: string;
     /** @type {string} */ port: string;
-    run(): AsyncGenerator<import("../../core/Intent.js").AskIntent | {
-        type: string;
-        level: any;
-        message: any;
-    }, any, unknown>;
+    run(): AsyncGenerator<import("../../core/Intent.js").AskIntent | import("../../core/Intent.js").LogIntent, any, unknown>;
     #private;
 }
 import { Model } from '@nan0web/types';

package/types/index.d.ts

@@ -1,3 +1,6 @@
+export { default as Element } from "./Model/Element.js";
+export { resolveContext } from "./utils/resolveContext.js";
+export { processI18n } from "./utils/processI18n.js";
 export { format } from "./format.js";
 export { default as Navigation } from "./domain/Navigation.js";
 export { default as FormMessage } from "./core/Form/Message.js";
@@ -7,9 +10,9 @@ export { default as OutputAdapter } from "./core/OutputAdapter.js";
 export { default as OutputMessage } from "./core/Message/OutputMessage.js";
 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";
 export { resolvePositionalArgs } from "./core/resolvePositionalArgs.js";
+export { tokens } from "./Theme/tokens.js";
 export * from "./core/Intent.js";
 export * from "./domain/index.js";
 export { IntentErrorModel } from "./core/IntentErrorModel.js";
@@ -33,16 +36,11 @@ export type AbortResponse = import("./core/Intent.js").AbortResponse;
 export type ShowData = import("./core/Intent.js").ShowData;
 export type AskOptions = import("./core/InputAdapter.js").AskOptions;
 export type ModelAsAppOptions = import("./domain/index.js").ModelAsAppOptions;
-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 '@nan0web/types';
 import Models 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, Models, Component, App };
+export { Locale, Model, Models, Component };
+export { default as Theme, getUserTheme, CustomTheme, DarkLightTheme, NightTheme, createTheme } from "./Theme/index.js";
 export { default as Error, CancelError } from "./core/Error/index.js";
+export { runFlow, flow, Prompt, Stream, Alert, Toast, Badge, Text, Table, Input, Select, Confirm, Multiselect, Mask, Password, Spinner, Progress, default as Flow } from "./core/Flow.js";

package/types/inspect.d.ts

@@ -1,3 +1,6 @@
 export * from "./testing/SnapshotRunner.js";
 export * from "./testing/verifySnapshot.js";
 export { SnapshotAuditor } from "./domain/app/SnapshotAuditor.js";
+export { IntentAuditor } from "./domain/app/IntentAuditor.js";
+export { JsIntentAuditor } from "./domain/app/JsIntentAuditor.js";
+export { PyIntentAuditor } from "./domain/app/PyIntentAuditor.js";

package/types/utils/format.d.ts

@@ -0,0 +1,5 @@
+export namespace format {
+    function currency(value: any, currency?: string, locale?: string): string;
+    function rate(value: any, locale?: string): string;
+    function number(value: any, locale?: string): string;
+}

package/types/utils/processI18n.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Обробляє i18n та замінює змінні в тексті.
+ * @param {any} input - Вміст для обробки.
+ * @param {Function} [t] - Функція перекладу.
+ * @param {Object} [data] - Дані для підстановки.
+ * @returns {any}
+ */
+export function processI18n(input: any, t?: Function, data?: any): any;

package/types/utils/resolveContext.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Resolves context-aware values in strings and objects.
+ * Supports:
+ * - References: `data:currencies`, `action:save`, `fn:calculate,100,USD,UAH`
+ * - Templates: `{{user.name}}`, `{{currencies[0]}}`
+ * - Scalars: numbers, booleans, etc. (passthrough)
+ *
+ * @param {Object} context - Application context (data, actions, functions)
+ * @param {*} value - Raw value to resolve
+ * @returns {*} Resolved value
+ */
+export function resolveContext(context: any, value: any): any;
+/**
+ * Resolves a context value or returns undefined if resolution fails.
+ * Used internally by renderers to safely resolve props.
+ *
+ * @param {Object} ctx - Context with data, actions and functions
+ * @param {string} value - String value to resolve
+ * @returns {*} Resolved value or undefined
+ */
+export function resolveContextValue(ctx: any, value: string): any;

package/src/App/Command/DepsCommand.js

@@ -1,24 +0,0 @@
-import UiMessage from '../../core/Message/Message.js'
-
-class DepsCommandBody {
-	static fix = {
-		help: 'Fix dependencies',
-		defaultValue: false,
-	}
-	constructor(input = {}) {
-		const { fix = DepsCommandBody.fix.defaultValue } = input
-		this.fix = !!fix
-	}
-}
-
-export class DepsCommand extends UiMessage {
-	static Body = DepsCommandBody
-	constructor(input = {}) {
-		const { body = new DepsCommandBody() } = UiMessage.parseBody(input, DepsCommandBody)
-		super(input)
-		/** @type {DepsCommandBody} */
-		this.body = body
-	}
-}
-
-export default DepsCommand

package/src/App/Core/CoreApp.js

@@ -1,125 +0,0 @@
-import { Message } from '@nan0web/co'
-import { typeOf } from '@nan0web/types'
-import UI from './UI.js'
-
-/** @typedef {Function} CommandFn */
-
-/**
- * Abstract base class for all apps.
- * Each app processes input commands and produces output.
- */
-export default class CoreApp {
-	/** @type {string} App name */
-	name
-
-	/** @type {Map<string, CommandFn>} Registered command handlers */
-	commands
-
-	/** @type {Record<string, any>} App state */
-	state
-
-	/** @type {Message} Starting command parsed from argv */
-	startCommand
-
-	/**
-	 * Creates a new CoreApp instance.
-	 * @param {object} props - CoreApp properties
-	 * @param {string} [props.name="CoreApp"] - App name
-	 * @param {object} [props.state={}] - Initial state object
-	 * @param {Message} [props.startCommand=new Message()] - Command line arguments to parse
-	 */
-	constructor(props = {}) {
-		const { name = 'CoreApp', state = {}, startCommand = new Message() } = props
-		this.name = String(name)
-		this.state = state
-		this.commands = new Map()
-		// @deprecated @todo fix the argv by moving to ui-cli.
-		this.startCommand = Message.from(startCommand ?? {})
-	}
-
-	/**
-	 * Sets app state.
-	 * @param {string|object} state - State key or object with multiple keys
-	 * @param {any} [value] - State value if state is a string key
-	 * @returns {object} Updated state
-	 */
-	set(state, value) {
-		if ('string' === typeof state) {
-			this.state[state] = value
-		} else {
-			Object.assign(this.state, state)
-		}
-		// @todo save state
-		return this.state
-	}
-
-	/**
-	 * Register a command handler.
-	 * @param {string} commandName - Name of the command to register
-	 * @param {Function} handler - async function or sync function that accepts params and returns output
-	 */
-	registerCommand(commandName, handler) {
-		if (!typeOf(Function)(handler)) {
-			throw new TypeError('Handler must be a function')
-		}
-		this.commands.set(commandName, handler)
-	}
-
-	/**
-	 * Returns a string representation of the app.
-	 * @returns {string} String representation including name and state
-	 */
-	toString() {
-		return `${this.constructor.name}(name=${this.name}, state=${JSON.stringify(this.state)})`
-	}
-
-	/**
-	 * Process a command message.
-	 * @param {Message} msg - Command to process
-	 * @param {UI} ui - UI instance to use for rendering
-	 * @returns {Promise<any>} Output of the command
-	 * @throws {Error} If the command is not registered
-	 */
-	async processCommand(msg, ui) {
-		const handler = this.commands.get(msg.constructor.name)
-		if (!handler) {
-			throw new Error(
-				[
-					'Unknown command',
-					': ',
-					msg.constructor.name,
-					'\n',
-					'Available commands',
-					': ',
-					[...this.commands.keys()].join(', '),
-				].join(''),
-			)
-		}
-		return await handler.apply(this, [msg, ui])
-	}
-
-	/**
-	 * Process an array of command messages sequentially.
-	 * @param {Message[]} Messages - Array of commands to process
-	 * @param {UI} ui - UI instance to use for rendering
-	 * @returns {Promise<any[]>} Array of command outputs
-	 */
-	async processCommands(Messages, ui) {
-		const results = []
-		for (const cmdMsg of Messages) {
-			const result = await this.processCommand(cmdMsg, ui)
-			results.push(result)
-		}
-		return results
-	}
-
-	/**
-	 * Select a command to run. Must be implemented by subclasses.
-	 * @param {UI} ui - UI instance for interaction
-	 * @returns {Promise<string>} Command name to execute
-	 * @throws {Error} Always thrown as this method must be implemented by subclasses
-	 */
-	async selectCommand(ui) {
-		throw new Error('Not implemented, must be implemented by subclass')
-	}
-}

package/src/App/Core/UI.js

@@ -1,63 +0,0 @@
-import { Message } from '@nan0web/co'
-import View from '../../View/View.js'
-import CoreApp from './CoreApp.js'
-import Widget from './Widget.js'
-
-/** @typedef {import("../../View/View.js").ComponentFn} ComponentFn */
-
-/**
- * Abstract UI class to connect apps and widgets.
- * Supports input/output data typed classes and views.
- */
-export default class UI extends Widget {
-	/** @type {CoreApp} The app instance connected to this UI */
-	app
-
-	/**
-	 * Creates a new UI instance.
-	 * @param {CoreApp} app - The app to connect to this UI
-	 * @param {View} [view] - View instance for rendering (default: new View())
-	 */
-	constructor(app, view = new View()) {
-		super(view)
-		this.app = app
-	}
-
-	/**
-	 * Convert raw input to Message array.
-	 * Must be implemented by subclasses.
-	 * @param {any} rawInput - Raw input to convert
-	 * @returns {Message[]} Array of command messages
-	 * @throws {Error} Always thrown as this method must be implemented by subclasses
-	 */
-	convertInput(rawInput) {
-		throw new Error('convertInput must be implemented by subclass')
-	}
-
-	/**
-	 * Sets up event handlers for UI process events.
-	 * @param {ComponentFn} UIProcess - Process view component
-	 */
-	show(UIProcess) {
-		if (!UIProcess) return
-		const onStart = () => {
-			// this.view.render(UIProcess)
-		}
-		const onData = () => {}
-		const onEnd = () => {}
-
-		this.on('start', onStart)
-		this.on('data', onData)
-		this.on('end', onEnd)
-	}
-
-	/**
-	 * Output results to the interface.
-	 * @param {any[]} results - Results to output
-	 */
-	output(results) {
-		results.forEach((result) => {
-			this.view.info(JSON.stringify(result))
-		})
-	}
-}

package/src/App/Core/Widget.js

@@ -1,61 +0,0 @@
-import EventProcessor from '@nan0web/event/oop'
-import View from '../../View/View.js'
-import { StreamEntry } from '@nan0web/db'
-import { UiMessage } from '../../core/index.js'
-
-/** @typedef {import("./UI.js").ComponentFn} ComponentFn */
-
-/**
- * Abstract Widget class.
- * Widget is a view with ability to input data in a specific format.
- * Input and output data are typed classes.
- */
-export default class Widget extends EventProcessor {
-	/** @type {View} The view associated with this widget */
-	view
-
-	/**
-	 * Creates a new Widget instance.
-	 * @param {View} [view] - View instance (default: new View())
-	 */
-	constructor(view = new View()) {
-		super()
-		this.view = view
-	}
-
-	/**
-	 * Ask user for input data of specific class.
-	 * @param {UiMessage} input - instance of UiMessage or similar
-	 * @returns {Promise<UiMessage | null>} instance of UiMessage or null
-	 */
-	async ask(input) {
-		return await this.view.ask(input)
-	}
-
-	/**
-	 * @param {AsyncGenerator<StreamEntry>} stream
-	 * @returns {Promise<void>}
-	 */
-	async read(stream) {
-		for await (const entry of stream) {
-			this.view.progress(true)(entry)
-		}
-	}
-
-	/**
-	 * Render output data using a view function.
-	 * @param {Function|string} viewFnOrName - View function or registered view name
-	 * @param {object} outputData - Typed output data instance
-	 * @returns {any} Rendered output
-	 * @throws {Error} If view component is not found when using string name
-	 */
-	render(viewFnOrName, outputData) {
-		/** @type {Function | ComponentFn | undefined} */
-		const viewFn = typeof viewFnOrName === 'string' ? this.view.get(viewFnOrName) : viewFnOrName
-
-		if (!viewFn) {
-			throw new Error(['View component not found', ': ', viewFnOrName].join(''))
-		}
-		return this.view.render(viewFn)(outputData)
-	}
-}

package/src/App/Core/index.js

@@ -1,11 +0,0 @@
-import CoreApp from './CoreApp.js'
-import UI from './UI.js'
-import Widget from './Widget.js'
-
-export { CoreApp, UI }
-
-export default {
-	App: CoreApp,
-	UI,
-	Widget,
-}

package/src/App/Scenario.js

@@ -1,45 +0,0 @@
-import App from './index.js'
-import UI from './Core/UI.js'
-
-/** @typedef {import("./Core/CoreApp.js").default} CoreApp */
-
-/**
- * Abstract Scenario class to test app logic.
- * Scenarios run input commands and verify output.
- */
-export default class Scenario {
-	/** @type {CoreApp} The app to run scenarios against */
-	app
-
-	/**
-	 * Creates a new Scenario instance.
-	 * @param {CoreApp} app - App instance to run scenarios against
-	 * @param {UI} ui - User interface
-	 * @throws {TypeError} If app is not an App.Core.App instance
-	 */
-	constructor(app, ui) {
-		if (!(app instanceof App.Core.App)) {
-			throw new TypeError('Scenario requires a App.Core.App instance')
-		}
-		this.app = app
-		this.ui = ui
-	}
-
-	/**
-	 * Run scenario with input commands and expected output.
-	 * @param {Array<any[]>} inputCommands - Array of command arrays
-	 * @param {Array<any>} expectedOutputs - Expected outputs for each command
-	 * @returns {Promise<boolean>} True if all outputs match expected
-	 */
-	async run(inputCommands, expectedOutputs) {
-		const commandMessages = inputCommands.map((arr) => App.Command.Message.parse(arr))
-		const outputs = await this.app.processCommands(commandMessages, this.ui)
-		if (outputs.length !== expectedOutputs.length) return false
-		for (let i = 0; i < outputs.length; i++) {
-			if (JSON.stringify(outputs[i]) !== JSON.stringify(expectedOutputs[i])) {
-				return false
-			}
-		}
-		return true
-	}
-}

package/src/App/User/Command/Message.js

@@ -1,3 +0,0 @@
-import UiMessage from '../../../core/Message/Message.js'
-
-export default UiMessage

package/src/App/User/Command/index.js

@@ -1,5 +0,0 @@
-import CommandMessage from './Message.js'
-
-export { CommandMessage }
-
-export default CommandMessage