@nan0web/ui 1.10.0 → 1.12.0

package/types/testing/SpecAdapter.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @typedef {Object} SpecAdapterOptions
+ * @property {typeof import('node:assert/strict')} [assert] Custom assertion library (falls back to node:assert in Node runtime)
+ */
+export class SpecAdapter {
+    /**
+     * @param {Array<object>} stream The remaining nan0 array without the first element.
+     * @param {SpecAdapterOptions} [options={}]
+     */
+    constructor(stream: Array<object>, options?: SpecAdapterOptions);
+    /** @type {Array<object>} */
+    stream: Array<object>;
+    /** @type {typeof import('node:assert/strict')} */
+    assert: typeof import("node:assert/strict");
+    /**
+     * @param {import('../core/Intent.js').AskIntent} intent
+     */
+    ask(intent: import("../core/Intent.js").AskIntent): Promise<{
+        value: any;
+        cancelled: boolean;
+    }>;
+    /**
+     * @param {import('../core/Intent.js').ShowIntent} intent
+     */
+    show(intent: import("../core/Intent.js").ShowIntent): Promise<void>;
+    /**
+     * @param {import('../core/Intent.js').LogIntent} intent
+     */
+    log(intent: import("../core/Intent.js").LogIntent): Promise<void>;
+    /**
+     * @param {import('../core/Intent.js').ProgressIntent} intent
+     */
+    progress(intent: import("../core/Intent.js").ProgressIntent): Promise<void>;
+    /**
+     * @param {import('../core/Intent.js').RenderIntent} intent
+     */
+    render(intent: import("../core/Intent.js").RenderIntent): Promise<void>;
+    /**
+     * @param {import('../core/Intent.js').AgentIntent} intent
+     */
+    agent(intent: import("../core/Intent.js").AgentIntent): Promise<{
+        success: boolean;
+        files: any;
+        message: any;
+    }>;
+    /**
+     * @param {import('../core/Intent.js').ResultIntent} intent
+     */
+    result(intent: import("../core/Intent.js").ResultIntent): Promise<void>;
+    #private;
+}
+export type SpecAdapterOptions = {
+    /**
+     * Custom assertion library (falls back to node:assert in Node runtime)
+     */
+    assert?: typeof assert | undefined;
+};
+import assert from 'node:assert/strict';

package/types/testing/SpecRunner.d.ts

@@ -0,0 +1,41 @@
+export class SpecRunner extends ModelAsApp {
+    static stream: {
+        help: string;
+        default: never[];
+    };
+    static registry: {
+        help: string;
+        default: {};
+    };
+    static UI: {
+        invalidStream: string;
+        invalidFirstStep: string;
+        missingAppName: string;
+        appNotFound: string;
+        invalidGenerator: string;
+        running: string;
+        unhandledSteps: string;
+    };
+    /**
+     * Run a Nan0Spec sequence programmatically (for unit tests).
+     *
+     * @param {Array<object>} stream The .nan0 intent stream array
+     * @param {Record<string, any>} registry A registry of Model Classes that can be mounted
+     * @param {typeof import('node:assert/strict')} [asserter] Custom assertion library
+     */
+    static execute(stream: Array<object>, registry: Record<string, any>, asserter?: typeof import("node:assert/strict")): Promise<any>;
+    /**
+     * @param {Partial<SpecRunner>} [data={}]
+     * @param {Partial<import('../index.js').ModelAsAppOptions> & { assert?: typeof import('node:assert/strict') }} [options={}]
+     */
+    constructor(data?: Partial<SpecRunner>, options?: Partial<import("../index.js").ModelAsAppOptions> & {
+        assert?: typeof import("node:assert/strict");
+    });
+    /** @type {Array<object>} The Nan0Spec stream */
+    stream: Array<object>;
+    /** @type {Record<string, any>} The registry of Model Classes */
+    registry: Record<string, any>;
+    #private;
+}
+export default SpecRunner;
+import { ModelAsApp } from '../domain/ModelAsApp.js';

package/types/testing/VisualAdapter.d.ts

@@ -1,9 +1,3 @@
-/**
- * VisualAdapter (Base)
- *
- * Базовий клас для візуальної трансформації інтенцій OLMUI.
- * Використовувана у @nan0web/ui як фундамент для спеціалізованих рендерерів.
- */
 export class VisualAdapter {
     /**
      * Конвертує одну інтенцію у просте текстове представлення.

package/types/testing/index.d.ts

@@ -1,3 +1,7 @@
 export * from "./LogicInspector.js";
 export * from "./VisualAdapter.js";
-export * from "./SnapshotInspector.js";
+export * from "../domain/app/SnapshotAuditor.js";
+export * from "./verifySnapshot.js";
+export * from "./CrashReporter.js";
+export { SpecRunner } from "./SpecRunner.js";
+export { SpecAdapter } from "./SpecAdapter.js";

package/types/testing/verifySnapshot.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Saves a logical JSONL snapshot sequence
+ * @param {Object} options
+ * @param {string} options.name Snapshot file name (e.g. 'uk/ExploreCatalog.jsonl')
+ * @param {Array<Object>} options.data Array of intents to serialize
+ * @param {typeof import('node:fs/promises')} [options.fs] Injected filesystem
+ * @param {typeof import('node:path')} [options.path] Injected path module
+ */
+export function verifySnapshot({ name, data, fs, path }: {
+    name: string;
+    data: Array<any>;
+    fs?: typeof import("node:fs/promises") | undefined;
+    path?: import("path").PlatformPath | undefined;
+}): Promise<void>;

package/src/testing/SnapshotInspector.js

@@ -1,84 +0,0 @@
-import fs from 'fs'
-import path from 'path'
-
-/**
- * SnapshotInspector
- * 
- * Рев'ювер для автоматичної перевірки Snapshot-зліпків на наявність артефактів,
- * неперекладених ключів та структурних помилок.
- * Реалізує правила "Zero-Hallucination Snapshot Validation".
- */
-export class SnapshotInspector {
-    /**
-     * Перевіряє вміст одного снепшоту.
-     * @param {string} content - Текстовий вміст .txt файлу галереї
-     * @param {string} locale - Локаль (uk, en)
-     * @param {string} [filename] - Ім'я файлу для перевірки на "глюки" (підкреслення)
-     * @returns {object} { score, errors }
-     */
-    static inspect(content, locale = 'uk', filename = '') {
-        const errors = []
-        const lines = content.split('\n')
-
-        // 0. Перевірка імені файлу (на прохання архітектора)
-        if (filename) {
-            if (/__|--/.test(filename)) {
-                errors.push(`Filename "${filename}" has multiple consecutive separators (glitch detected).`)
-            }
-            if (filename.length < 3) {
-                errors.push(`Filename "${filename}" is too short.`)
-            }
-        }
-
-        lines.forEach((line, index) => {
-            const lineNum = index + 1
-            const trimmed = line.trim()
-
-            // 1. Неперекладені i18n ключі (крапки в словах)
-            // Виключаємо імена компонентів, атрибути RENDER-тегів, та числа з крапкою (версії, координати)
-            const isAttribute = trimmed.includes('="')
-            const isDotNumber = /^-?\d+\.\d+$/.test(trimmed)
-            
-            if (/\w+\.\w+/.test(line) && !line.includes('ui-') && !line.includes('http') && !isAttribute && !isDotNumber) {
-                errors.push(`Line ${lineNum}: Possible untranslated key found: "${trimmed}"`)
-            }
-
-            // 2. Технічні артефакти
-            if (line.includes('[object Object]')) {
-                errors.push(`Line ${lineNum}: Critical artifact "[object Object]" found.`)
-            }
-            if (line.includes('undefined')) {
-                errors.push(`Line ${lineNum}: Critical artifact "undefined" found.`)
-            }
-            if (line.includes('NaN')) {
-                errors.push(`Line ${lineNum}: Critical artifact "NaN" found.`)
-            }
-
-            // 3. Англійські слова в українській локалі (базові)
-            if (locale === 'uk') {
-                const enWords = ['Back', 'Select', 'Cancel', 'Submit', 'Confirm', 'Delete', 'Information', 'Success', 'Warning', 'Error']
-                enWords.forEach(word => {
-                    const regex = new RegExp(`\\b${word}\\b`, 'i')
-                    // Перевіряємо тільки якщо це не частина тегу <ui-...> або атрибут
-                    if (regex.test(line)) {
-                        const isTag = line.includes(`<ui-${word.toLowerCase()}`) || line.includes(`[RENDER] <ui-`)
-                        const isAsk = line.includes(`[ASK] ${word}`)
-                        if (!isTag && !isAsk && !isAttribute) {
-                            errors.push(`Line ${lineNum}: English word "${word}" found in "uk" locale.`)
-                        }
-                    }
-                })
-            }
-            
-            // 4. Помилки роутингу
-            if (line.includes('🚨 Path not found')) {
-                errors.push(`Line ${lineNum}: Routing error "Path not found".`)
-            }
-        })
-
-        return {
-            score: errors.length === 0 ? 100 : Math.max(0, 100 - errors.length * 10),
-            errors
-        }
-    }
-}

package/types/App/Command/Options.d.ts

@@ -1,43 +0,0 @@
-export default CommandOptions
-/**
- * Represents command options with default values.
- * Provides utilities for handling command line options.
- */
-declare class CommandOptions {
-	/**
-	 * Default option values.
-	 * @type {object}
-	 * @property {boolean} help - Whether help is requested
-	 * @property {string} cwd - Current working directory
-	 */
-	static DEFAULTS: object
-	/**
-	 * 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: CommandOptions | object): CommandOptions
-	/**
-	 * 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?: { help?: boolean | undefined; cwd?: string | undefined })
-	/** @type {boolean} Whether help is requested */
-	help: boolean
-	/** @type {string} Current working directory */
-	cwd: string
-	/** @type {Record<string, any>} */
-	get DEFAULTS(): Record<string, any>
-	/**
-	 * Checks if all options have their default values.
-	 * @returns {boolean} True if all options are at their default values, false otherwise
-	 */
-	get empty(): boolean
-	/**
-	 * Converts the options to a string representation.
-	 * @returns {string} String representation of the options or "<no options>" if none set
-	 */
-	toString(): string
-}

package/types/App/Command/index.d.ts

@@ -1,8 +0,0 @@
-declare namespace _default {
-	export { CommandMessage as Message }
-	export { CommandOptions as Options }
-}
-export default _default
-import { CommandMessage } from '@nan0web/co'
-import CommandOptions from './Options.js'
-export { CommandMessage, CommandOptions }

package/types/App/User/Command/Options.d.ts

@@ -1,34 +0,0 @@
-export default UserAppCommandOptions
-/**
- * Extends CommandOptions to include user-specific options.
- */
-declare class UserAppCommandOptions {
-	/**
-	 * Default option values including inherited ones.
-	 * @type {object}
-	 * @property {boolean} help - Whether help is requested
-	 * @property {string} cwd - Current working directory
-	 * @property {string} user - User name
-	 */
-	static DEFAULTS: object
-	/**
-	 * Creates a UserAppCommandOptions instance from the given props.
-	 * @param {UserAppCommandOptions|object} props - The properties to create from
-	 * @returns {UserAppCommandOptions} A UserAppCommandOptions instance
-	 */
-	static from(props: UserAppCommandOptions | object): UserAppCommandOptions
-	/**
-	 * Creates a new UserAppCommandOptions instance.
-	 * @param {object} props - Options properties
-	 * @param {boolean} [props.help=false] - Whether help is requested
-	 * @param {string} [props.cwd=""] - Current working directory
-	 * @param {string} [props.user=""] - User name
-	 */
-	constructor(props?: {
-		help?: boolean | undefined
-		cwd?: string | undefined
-		user?: string | undefined
-	})
-	/** @type {string} User name */
-	user: string
-}

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

@@ -1,71 +0,0 @@
-/** @typedef {Partial<Message> | null} InputMessageValue */
-/**
- * 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
-}
-export type InputMessageValue = Partial<Message> | null
-import { Message } from '@nan0web/co'

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

@@ -1,24 +0,0 @@
-/**
- * HeroModel — OLMUI Model-as-Schema
- * Main landing page banner with a big heading, description, and primary CTA.
- */
-export class HeroModel extends Model {
-    static $id: string;
-    static title: {
-        help: string;
-        placeholder: string;
-        default: string;
-        required: boolean;
-    };
-    static description: {
-        help: string;
-        placeholder: string;
-        default: string;
-    };
-    static actions: {
-        help: string;
-        type: string;
-        default: never[];
-    };
-}
-import { Model } from '@nan0web/core';

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

@@ -1,32 +0,0 @@
-/**
- * ShowcaseAppModel — OLMUI Model-as-Schema
- * A container model representing the entire UI library showcase.
- * @property {string} title - App title
- * @property {any[]} sections - Collection of UI sections
- */
-export class ShowcaseAppModel extends Model {
-    static $id: string;
-    static title: {
-        help: string;
-        default: string;
-    };
-    static sections: {
-        help: string;
-        type: string;
-        default: never[];
-    };
-    /**
-     * OLMUI Generator — drives the showcase rendering.
-     */
-    run(): AsyncGenerator<{
-        type: string;
-        message: any;
-        component: string;
-    }, {
-        type: string;
-        data: {
-            success: boolean;
-        };
-    }, unknown>;
-}
-import { Model } from '@nan0web/core';

package/types/testing/SnapshotInspector.d.ts

@@ -1,17 +0,0 @@
-/**
- * SnapshotInspector
- *
- * Рев'ювер для автоматичної перевірки Snapshot-зліпків на наявність артефактів,
- * неперекладених ключів та структурних помилок.
- * Реалізує правила "Zero-Hallucination Snapshot Validation".
- */
-export class SnapshotInspector {
-    /**
-     * Перевіряє вміст одного снепшоту.
-     * @param {string} content - Текстовий вміст .txt файлу галереї
-     * @param {string} locale - Локаль (uk, en)
-     * @param {string} [filename] - Ім'я файлу для перевірки на "глюки" (підкреслення)
-     * @returns {object} { score, errors }
-     */
-    static inspect(content: string, locale?: string, filename?: string): object;
-}