@nan0web/ui 1.8.0 → 1.10.0

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

@@ -0,0 +1,28 @@
+/**
+ * TabsModel — OLMUI Model-as-Schema
+ * Tab container with selectable panels.
+ */
+export class TabsModel extends Model {
+    static $id: string;
+    static active: {
+        help: string;
+        default: number;
+        type: string;
+    };
+    static tabs: {
+        help: string;
+        type: string;
+        default: never[];
+    };
+    /**
+     * @param {Partial<TabsModel> | Record<string, any>} data Model input data.
+     * @param {object} [options] Extended options (db, etc.)
+     */
+    constructor(data?: Partial<TabsModel> | Record<string, any>, options?: object);
+    /** @type {number} Index of the currently active tab */ active: number;
+    /** @type {Array<{label: string, content: string}>} Tab definitions */ tabs: Array<{
+        label: string;
+        content: string;
+    }>;
+}
+import { Model } from '@nan0web/types';

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

@@ -0,0 +1,18 @@
+/**
+ * TestimonialModel — OLMUI Model-as-Schema
+ * Extends CommentModel with a rating field for testimonials/reviews.
+ */
+export class TestimonialModel extends CommentModel {
+    static rating: {
+        help: string;
+        default: number;
+        type: string;
+    };
+    /**
+     * @param {Partial<TestimonialModel> | Record<string, any>} data Model input data.
+     * @param {object} [options] Extended options (db, etc.)
+     */
+    constructor(data?: Partial<TestimonialModel> | Record<string, any>, options?: object);
+    /** @type {number} Rating from 1 to 5 stars */ rating: number;
+}
+import { CommentModel } from './CommentModel.js';

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

@@ -0,0 +1,33 @@
+/**
+ * TimelineItemModel — OLMUI Model-as-Schema
+ * A single entry on a timeline (event, milestone, changelog).
+ */
+export class TimelineItemModel extends Model {
+    static $id: string;
+    static date: {
+        help: string;
+        placeholder: string;
+        default: string;
+        required: boolean;
+    };
+    static title: {
+        help: string;
+        placeholder: string;
+        default: string;
+        required: boolean;
+    };
+    static description: {
+        help: string;
+        placeholder: string;
+        default: string;
+    };
+    /**
+     * @param {Partial<TimelineItemModel> | Record<string, any>} data Model input data.
+     * @param {object} [options] Extended options (db, etc.)
+     */
+    constructor(data?: Partial<TimelineItemModel> | Record<string, any>, options?: object);
+    /** @type {string} Date of the event */ date: string;
+    /** @type {string} Event or milestone title */ title: string;
+    /** @type {string} Detailed description of the event */ description: string;
+}
+import { Model } from '@nan0web/types';

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

@@ -0,0 +1,27 @@
+/**
+ * TimelineModel — OLMUI Model-as-Schema
+ * A collection of timeline events (changelog, roadmap, history).
+ */
+export class TimelineModel extends Model {
+    static $id: string;
+    static title: {
+        help: string;
+        placeholder: string;
+        default: string;
+    };
+    static items: {
+        help: string;
+        type: string;
+        hint: typeof TimelineItemModel;
+        default: never[];
+    };
+    /**
+     * @param {Partial<TimelineModel> | Record<string, any>} data Model input data.
+     * @param {object} [options] Extended options (db, etc.)
+     */
+    constructor(data?: Partial<TimelineModel> | Record<string, any>, options?: object);
+    /** @type {string} Timeline section title */ title: string;
+    /** @type {TimelineItemModel[]} Array of timeline events */ items: TimelineItemModel[];
+}
+import { Model } from '@nan0web/types';
+import { TimelineItemModel } from './TimelineItemModel.js';

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

@@ -1,62 +1,33 @@
 /**
- * @typedef {'success'|'error'|'info'|'warning'} ToastVariant
- * @typedef {Object} ToastData
- * @property {string} [message]
- * @property {ToastVariant} [variant]
- * @property {number} [duration]
- * @property {boolean} [open]
- */
-/**
- * Model-as-Schema for Toast notification component.
- * Represents a transient message displayed to the user.
+ * Model-as-Schema for Toast notification.
  */
 export class ToastModel extends Model {
-    static message: {
-        help: string;
-        default: string;
-        type: string;
-    };
     static variant: {
         help: string;
         default: string;
         options: string[];
     };
-    static duration: {
+    static message: {
         help: string;
-        default: number;
+        default: string;
         type: string;
     };
-    static open: {
+    static duration: {
         help: string;
-        default: boolean;
+        default: number;
         type: string;
     };
     /**
-     * @param {ToastData | any} [data]
+     * @param {Partial<ToastModel> | Record<string, any>} data Model input data.
+     * @param {object} [options] Extended options (db, etc.)
      */
-    constructor(data?: ToastData | any);
-    /** @type {string|undefined} */ message: string | undefined;
-    /** @type {ToastVariant|undefined} */ variant: ToastVariant | undefined;
-    /** @type {number|undefined} */ duration: number | undefined;
-    /** @type {boolean|undefined} */ open: boolean | undefined;
-    run(): AsyncGenerator<{
-        type: string;
-        level: string;
-        message: string | undefined;
-        component: string;
-        model: any;
-    }, {
-        type: string;
-        data: {
-            closed: boolean;
-        };
-    }, unknown>;
+    constructor(data?: Partial<ToastModel> | Record<string, any>, options?: object);
+    /** @type {'info'|'success'|'warn'|'error'} Notification color scheme */ variant: "info" | "success" | "warn" | "error";
+    /** @type {string} Text displayed in the toast */ message: string;
+    /** @type {number} Auto-dismiss timeout in ms */ duration: number;
+    /**
+     * @returns {AsyncGenerator<any, any, any>}
+     */
+    run(): AsyncGenerator<any, any, any>;
 }
-export type ToastVariant = "success" | "error" | "info" | "warning";
-export type ToastData = {
-    message?: string | undefined;
-    variant?: ToastVariant | undefined;
-    duration?: number | undefined;
-    open?: boolean | undefined;
-};
-import { Model } from '@nan0web/core';
+import { Model } from '@nan0web/types';

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

@@ -1,13 +1,3 @@
-/**
- * @typedef {Object} TreeNode
- * @property {string} label
- * @property {boolean} [expanded]
- * @property {TreeNode[]} [children]
- */
-/**
- * @typedef {Object} TreeData
- * @property {TreeNode[]} [data]
- */
 /**
  * Model-as-Schema for Tree component.
  * Represents a hierarchical selection or navigation structure.
@@ -19,31 +9,18 @@ export class TreeModel extends Model {
         default: never[];
     };
     /**
-     * @param {TreeData | any} [data]
+     * @param {Partial<TreeModel> | Record<string, any>} data Model input data.
+     * @param {object} [options] Extended options (db, etc.)
      */
-    constructor(data?: TreeData | any);
-    /** @type {TreeNode[]|undefined} */ data: TreeNode[] | undefined;
-    run(): AsyncGenerator<{
-        type: string;
-        field: string;
-        schema: {
-            help: string;
-        };
-        component: string;
-        model: any;
-    }, {
-        type: string;
-        data: {
-            selected: any;
-        };
-    }, unknown>;
+    constructor(data?: Partial<TreeModel> | Record<string, any>, options?: object);
+    /** @type {Array<{label: string, expanded?: boolean, children?: any[]}>} Tree nodes */ data: Array<{
+        label: string;
+        expanded?: boolean;
+        children?: any[];
+    }>;
+    /**
+     * @returns {AsyncGenerator<any, any, any>}
+     */
+    run(): AsyncGenerator<any, any, any>;
 }
-export type TreeNode = {
-    label: string;
-    expanded?: boolean | undefined;
-    children?: TreeNode[] | undefined;
-};
-export type TreeData = {
-    data?: TreeNode[] | undefined;
-};
-import { Model } from '@nan0web/core';
+import { Model } from '@nan0web/types';

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

@@ -8,3 +8,23 @@ export { ToastModel } from "./ToastModel.js";
 export { SelectModel } from "./SelectModel.js";
 export { AutocompleteModel } from "./AutocompleteModel.js";
 export { TreeModel } from "./TreeModel.js";
+export { TabsModel } from "./TabsModel.js";
+export { AccordionModel } from "./AccordionModel.js";
+export { FAQModel } from "./FAQModel.js";
+export { GalleryModel } from "./GalleryModel.js";
+export { PriceModel } from "./PriceModel.js";
+export { PricingModel } from "./PricingModel.js";
+export { PricingSectionModel } from "./PricingSectionModel.js";
+export { CommentModel } from "./CommentModel.js";
+export { TestimonialModel } from "./TestimonialModel.js";
+export { StatsItemModel } from "./StatsItemModel.js";
+export { StatsModel } from "./StatsModel.js";
+export { TimelineItemModel } from "./TimelineItemModel.js";
+export { TimelineModel } from "./TimelineModel.js";
+export { HeaderVisibilityModel } from "./HeaderVisibilityModel.js";
+export { HeaderConfigModel } from "./HeaderConfigModel.js";
+export { FooterVisibilityModel } from "./FooterVisibilityModel.js";
+export { FooterConfigModel } from "./FooterConfigModel.js";
+export { EmptyStateModel } from "./EmptyStateModel.js";
+export { BannerModel } from "./BannerModel.js";
+export { ProfileDropdownModel } from "./ProfileDropdownModel.js";

package/types/domain/index.d.ts

@@ -1,4 +1,7 @@
 export { SandboxModel } from "./SandboxModel.js";
 export { ShowcaseAppModel } from "./ShowcaseAppModel.js";
 export { default as Navigation } from "./Navigation.js";
-export { ButtonModel, ConfirmModel, InputModel, SpinnerModel, TableModel, ToastModel, SelectModel, AutocompleteModel, TreeModel } from "./components/index.js";
+export { default as HeaderModel } from "./HeaderModel.js";
+export { default as FooterModel } from "./FooterModel.js";
+export { default as HeroModel } from "./HeroModel.js";
+export { ButtonModel, ConfirmModel, InputModel, SpinnerModel, TableModel, ToastModel, SelectModel, AutocompleteModel, TreeModel, TabsModel, AccordionModel, GalleryModel, PriceModel, PricingModel, CommentModel, TestimonialModel, StatsItemModel, StatsModel, TimelineItemModel, TimelineModel, HeaderVisibilityModel, HeaderConfigModel, FooterVisibilityModel, FooterConfigModel, EmptyStateModel, BannerModel, ProfileDropdownModel } from "./components/index.js";

package/types/index.d.ts

@@ -1,4 +1,5 @@
 export { format } from "./format.js";
+export { default as Navigation } from "./domain/Navigation.js";
 export { default as FormMessage } from "./core/Form/Message.js";
 export { default as FormInput } from "./core/Form/Input.js";
 export { default as InputAdapter } from "./core/InputAdapter.js";

package/types/testing/GalleryGenerator.d.ts

@@ -0,0 +1 @@
+export {};

package/types/testing/LogicInspector.d.ts

@@ -0,0 +1,22 @@
+/**
+ * LogicInspector
+ *
+ * Базовий клас для захоплення "Логічних зліпків" (Intent Stream) будь-яких моделей OLMUI.
+ * Дозволяє виконувати чисто-логічне тестування без прив'язки до рендерингу.
+ */
+export class LogicInspector {
+    /**
+     * Виконує генератор моделі та записує послідовність усіх інтенцій.
+     * @param {AsyncGenerator<import('../core/Intent.js').Intent, import('../core/Intent.js').ResultIntent, import('../core/Intent.js').IntentResponse>} modelStream - результат виклику model.run()
+     * @param {object} options
+     * @param {Array<any> | ((locale: string) => Array<any>)} [options.inputs] - черга вхідних значень для askIntent
+     * @param {string} [options.locale] - локаль для тестів
+     * @param {function} [options.t] - функція перекладу
+     * @returns {Promise<Array<any>>} Intent Stream Log
+     */
+    static capture(modelStream: AsyncGenerator<import("../core/Intent.js").Intent, import("../core/Intent.js").ResultIntent, import("../core/Intent.js").IntentResponse>, { inputs, locale, t }?: {
+        inputs?: any[] | ((locale: string) => Array<any>) | undefined;
+        locale?: string | undefined;
+        t?: Function | undefined;
+    }): Promise<Array<any>>;
+}

package/types/testing/SnapshotInspector.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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;
+}

package/types/testing/VisualAdapter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * VisualAdapter (Base)
+ *
+ * Базовий клас для візуальної трансформації інтенцій OLMUI.
+ * Використовувана у @nan0web/ui як фундамент для спеціалізованих рендерерів.
+ */
+export class VisualAdapter {
+    /**
+     * Конвертує одну інтенцію у просте текстове представлення.
+     * @param {object} intent - Intent entry from LogicInspector
+     * @param {function} [t] - i18n translate function
+     * @returns {string} Raw description
+     */
+    static render(intent: object, t?: Function): string;
+}

package/types/testing/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./LogicInspector.js";
+export * from "./VisualAdapter.js";
+export * from "./SnapshotInspector.js";