@nan0web/ui 1.8.0 → 1.10.0

package/src/domain/components/index.js

@@ -1,4 +1,6 @@
 // Exports for Component Models
+
+// Interactive Components
 export { BreadcrumbModel } from './BreadcrumbModel.js'
 export { ButtonModel } from './ButtonModel.js'
 export { ConfirmModel } from './ConfirmModel.js'
@@ -9,3 +11,35 @@ 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'
+
+// Pricing
+export { PriceModel } from './PriceModel.js'
+export { PricingModel } from './PricingModel.js'
+export { PricingSectionModel } from './PricingSectionModel.js'
+
+// Hero
+
+// Social / Feedback
+export { CommentModel } from './CommentModel.js'
+export { TestimonialModel } from './TestimonialModel.js'
+
+// Data Display
+export { StatsItemModel } from './StatsItemModel.js'
+export { StatsModel } from './StatsModel.js'
+export { TimelineItemModel } from './TimelineItemModel.js'
+export { TimelineModel } from './TimelineModel.js'
+
+// Visibility Configs
+export { HeaderVisibilityModel } from './HeaderVisibilityModel.js'
+export { HeaderConfigModel } from './HeaderConfigModel.js'
+export { FooterVisibilityModel } from './FooterVisibilityModel.js'
+export { FooterConfigModel } from './FooterConfigModel.js'
+
+// Business Critical
+export { EmptyStateModel } from './EmptyStateModel.js'
+export { BannerModel } from './BannerModel.js'
+export { ProfileDropdownModel } from './ProfileDropdownModel.js'

package/src/domain/index.js

@@ -2,6 +2,12 @@
 export { SandboxModel } from './SandboxModel.js'
 export { ShowcaseAppModel } from './ShowcaseAppModel.js'
 export { default as Navigation } from './Navigation.js'
+export { Language } from '@nan0web/i18n/src/domain/Language.js'
+
+// Layout Models (Phase 1)
+export { default as HeaderModel } from './HeaderModel.js'
+export { default as FooterModel } from './FooterModel.js'
+export { default as HeroModel } from './HeroModel.js'
 
 // Component Models
 export {
@@ -14,4 +20,22 @@ export {
 	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/src/index.js

@@ -11,6 +11,8 @@ import App from './App/index.js'
 
 export { Frame, FrameProps, Locale, StdIn, StdOut, View, RenderOptions, Model, Component, App }
 export { format } from './format.js'
+export { default as Navigation } from './domain/Navigation.js'
+export { Language } from '@nan0web/i18n/src/domain/Language.js'
 
 // export default App
 export { default as FormMessage } from './core/Form/Message.js'

package/src/testing/GalleryGenerator.js

@@ -0,0 +1,85 @@
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import yaml from 'js-yaml'
+import { LogicInspector } from './LogicInspector.js'
+import { VisualAdapter } from './VisualAdapter.js'
+import * as Models from '../domain/index.js'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const rootDir = path.resolve(__dirname, '../../')
+const dataDir = path.resolve(rootDir, 'docs/data')
+const snapshotsDir = path.resolve(rootDir, 'snapshots/core')
+
+// Clean before generation
+if (fs.existsSync(snapshotsDir)) fs.rmSync(snapshotsDir, { recursive: true, force: true })
+fs.mkdirSync(snapshotsDir, { recursive: true })
+
+const groups = {
+    Actions: ['Button', 'Toggle'],
+    Forms: ['Input', 'Select', 'Slider', 'Autocomplete', 'Color', 'Shadow'],
+    Data: ['Accordion', 'Card', 'Sortable', 'Table', 'Tree', 'CodeBlock', 'Markdown', 'Badge'],
+    Feedback: ['Alert', 'Confirm', 'Modal', 'ProgressBar', 'Spinner', 'Toast'],
+    System: ['LangSelect', 'ThemeToggle'],
+}
+
+function getCategory(comp) {
+    for (const [cat, comps] of Object.entries(groups)) {
+        if (comps.includes(comp)) return cat
+    }
+    return 'Other'
+}
+
+async function generate() {
+    const langs = fs.readdirSync(dataDir).filter(d => fs.statSync(path.join(dataDir, d)).isDirectory() && d !== '_')
+
+    for (const lang of langs) {
+        const langDir = path.join(dataDir, lang)
+        const components = fs.readdirSync(langDir).filter(f => f.endsWith('.yaml'))
+
+        for (const file of components) {
+            const compName = file.replace('.yaml', '')
+            const category = getCategory(compName)
+            const text = fs.readFileSync(path.join(langDir, file), 'utf-8')
+            const data = yaml.load(text)
+
+            // Variations are in data.content
+            const variations = data.content || []
+            
+            for (let i = 0; i < variations.length; i++) {
+                const varData = variations[i][compName] || variations[i]
+                
+                // Get variation name from 'content', 'title', 'message', or fallback to index
+                let varName = varData.content || varData.title || varData.message || `var${i + 1}`
+                if (typeof varName !== 'string') varName = `var${i + 1}`
+                
+                // Clean filename: allow Ukrainian, but replace spaces/special chars with single underscore
+                const safeVarName = varName
+                    .trim()
+                    .toLowerCase()
+                    .replace(/[./\\:]/g, '_') // Replace paths/dots
+                    .replace(/\s+/g, '_')      // Replace spaces
+                    .replace(/_{2,}/g, '_')   // No double underscores
+                    .slice(0, 50)              // Max length
+
+                // Logic Capture
+                /** @type {() => AsyncGenerator<import('../core/Intent.js').Intent, import('../core/Intent.js').ResultIntent, any>} */
+                const modelStream = async function* () {
+                    yield { type: 'render', component: `ui-${compName.toLowerCase()}`, props: varData }
+                    return { type: 'result', data: { ok: true } }
+                }
+
+                const intents = await LogicInspector.capture(modelStream())
+                const snapshot = intents.map(it => VisualAdapter.render(it)).join('\n')
+
+                const outPath = path.join(snapshotsDir, lang, category, compName)
+                if (!fs.existsSync(outPath)) fs.mkdirSync(outPath, { recursive: true })
+                
+                fs.writeFileSync(path.join(outPath, `${safeVarName}.txt`), snapshot)
+                console.log(`📸 Generated snapshot for ${lang}/${category}/${compName}/${safeVarName}`)
+            }
+        }
+    }
+}
+
+generate().catch(console.error)

package/src/testing/LogicInspector.js

@@ -0,0 +1,55 @@
+import { runGenerator } from '../core/GeneratorRunner.js'
+
+/**
+ * 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 async capture(modelStream, { inputs = [], locale = 'uk', t = (k) => k } = {}) {
+        const intents = []
+        let inputIdx = 0
+        const resolvedInputs = typeof inputs === 'function' ? inputs(locale) : inputs
+
+        const recordingAdapter = {
+            /** @param {import('../core/Intent.js').AskIntent} i */
+            ask: async (i) => {
+                const value = resolvedInputs[inputIdx++]
+                const entry = { type: 'ask', field: i.field, schema: i.schema, input: value }
+                intents.push(entry)
+                return { value }
+            },
+            /** @param {import('../core/Intent.js').LogIntent} i */
+            log: async (i) => {
+                intents.push({ type: 'log', level: i.level || 'info', message: i.message })
+            },
+            /** @param {import('../core/Intent.js').ProgressIntent} i */
+            progress: async (i) => {
+                intents.push({ type: 'progress', message: i.message })
+            },
+            /** @param {import('../core/Intent.js').RenderIntent} i */
+            render: async (i) => {
+                intents.push({ type: 'render', component: i.component, props: i.props })
+            },
+            /** @param {import('../core/Intent.js').ResultIntent} i */
+            result: async (i) => {
+                intents.push({ type: 'result', data: i.data })
+            },
+            t
+        }
+
+        // Викликаємо базовий раннер з нашим записуючим адаптером
+        await runGenerator(modelStream, recordingAdapter)
+        return intents
+    }
+}

package/src/testing/SnapshotInspector.js

@@ -0,0 +1,84 @@
+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/src/testing/VisualAdapter.js

@@ -0,0 +1,41 @@
+/**
+ * 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, t = (k) => k) {
+        switch (intent.type) {
+            case 'ask':
+                return `[ASK] ${intent.field}: ${intent.input !== undefined ? intent.input : '...'}`
+            case 'progress':
+                return `[PROGRESS] ${intent.message || ''}`
+            case 'log':
+                return `[LOG ${intent.level?.toUpperCase() || 'INFO'}] ${typeof intent.message === 'object' ? JSON.stringify(intent.message) : intent.message}`
+            case 'render': {
+                const { content, ...propsData } = intent.props || {}
+                const props = Object.entries(propsData)
+                    .map(([k, v]) => `  ${k}="${typeof v === 'object' ? JSON.stringify(v) : v}"`)
+                    .join('\n')
+                
+                if (content) {
+                    const attrs = props ? `\n${props}\n` : ' '
+                    return `[RENDER] <${intent.component}${attrs}>${content}</${intent.component}>`
+                }
+                
+                return `[RENDER] <${intent.component}${props ? '\n' + props + '\n' : ''}>`
+            }
+            case 'result':
+                return `[RESULT] ${JSON.stringify(intent.data)}`
+            default:
+                return `[UNKNOWN: ${intent.type}] ${JSON.stringify(intent)}`
+        }
+    }
+}

package/src/testing/index.js

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

package/types/Model/index.d.ts

@@ -1,6 +1,64 @@
 export { User };
-declare namespace _default {
-    export { User };
-}
-export default _default;
+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;
+};

package/types/core/Form/Form.d.ts

@@ -89,9 +89,9 @@ export default class UIForm extends FormMessage {
     /**
      * Validates the entire form.
      *
-     * @returns {Map<string, string>} Map of validation errors, empty if valid.
+     * @returns {any}
      */
-    validate(): Map<string, string>;
+    validate(): any;
     /**
      * Validates a single field.
      *

package/types/core/GeneratorRunner.d.ts

@@ -32,6 +32,10 @@ export type AdapterHandlers = {
      * Handler for 'log' intents. Optional (defaults to no-op).
      */
     log?: ((intent: import("./Intent.js").LogIntent) => void | Promise<void>) | undefined;
+    /**
+     * Handler for 'render' intents (visual component injection). Optional.
+     */
+    render?: ((intent: import("./Intent.js").RenderIntent) => void | Promise<void>) | undefined;
     /**
      * Handler for the final 'result'. Optional (defaults to no-op).
      */

package/types/core/Intent.d.ts

@@ -53,9 +53,17 @@ export function validateIntent(intent: any): intent is Intent;
  * @property {'result'} type
  * @property {*} data - The raw result data (JSON-serializable).
  */
+/**
+ * Model requests rendering of a pure UI component (Header, Footer, Static Map).
+ * No response expected from the logic loop.
+ * @typedef {Object} RenderIntent
+ * @property {'render'} type
+ * @property {string} component - Component name (e.g. 'App.Layout.Header').
+ * @property {object} props - Static props for the component.
+ */
 /**
  * Union of all possible yielded intents.
- * @typedef {AskIntent | ProgressIntent | LogIntent} Intent
+ * @typedef {AskIntent | ProgressIntent | LogIntent | RenderIntent} Intent
  */
 /**
  * Response to an AskIntent. Adapter provides the collected value.
@@ -82,7 +90,7 @@ 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
  */
-export const INTENT_TYPES: readonly ["ask", "progress", "log"];
+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;
@@ -93,6 +101,11 @@ export function log(level: any, message: any, data?: {}): {
     level: any;
     message: any;
 };
+export function render(component: any, props?: {}): {
+    type: string;
+    component: any;
+    props: {};
+};
 export function result(data: any): {
     type: string;
     data: any;
@@ -186,10 +199,25 @@ export type ResultIntent = {
      */
     data: any;
 };
+/**
+ * Model requests rendering of a pure UI component (Header, Footer, Static Map).
+ * No response expected from the logic loop.
+ */
+export type RenderIntent = {
+    type: "render";
+    /**
+     * - Component name (e.g. 'App.Layout.Header').
+     */
+    component: string;
+    /**
+     * - Static props for the component.
+     */
+    props: object;
+};
 /**
  * Union of all possible yielded intents.
  */
-export type Intent = AskIntent | ProgressIntent | LogIntent;
+export type Intent = AskIntent | ProgressIntent | LogIntent | RenderIntent;
 /**
  * Response to an AskIntent. Adapter provides the collected value.
  * The value MUST conform to the type described in the requested FieldSchema.

package/types/core/IntentErrorModel.d.ts

@@ -19,6 +19,10 @@ export class IntentErrorModel {
         help: string;
         error: string;
     };
+    static render_missing_component: {
+        help: string;
+        error: string;
+    };
     static adapter_missing_ask: {
         help: string;
         error: string;

package/types/core/index.d.ts

@@ -13,4 +13,4 @@ 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";
-export { validateIntent, ask, progress, log, result, INTENT_TYPES, isModelSchema } from "./Intent.js";
+export { validateIntent, ask, progress, log, render, result, INTENT_TYPES, isModelSchema } from "./Intent.js";

package/types/domain/FooterModel.d.ts

@@ -0,0 +1,52 @@
+/**
+ * FooterModel — OLMUI Model-as-Schema
+ * Universal footer structure: copyright, version, license, navigation, sharing, languages.
+ */
+export default class FooterModel extends Model {
+    static $id: string;
+    static copyright: {
+        help: string;
+        placeholder: string;
+        default: string;
+    };
+    static version: {
+        help: string;
+        placeholder: string;
+        default: string;
+    };
+    static license: {
+        help: string;
+        placeholder: string;
+        default: string;
+    };
+    static nav: {
+        help: string;
+        type: string;
+        hint: typeof Navigation;
+        default: never[];
+    };
+    static share: {
+        help: string;
+        type: string;
+        hint: typeof Navigation;
+        default: never[];
+    };
+    static langs: {
+        help: string;
+        type: string;
+        default: never[];
+    };
+    /**
+     * @param {Partial<FooterModel> | Record<string, any>} data Model input data.
+     * @param {object} [options] Extended options (db, etc.)
+     */
+    constructor(data?: Partial<FooterModel> | Record<string, any>, options?: object);
+    /** @type {string} Copyright text */ copyright: string;
+    /** @type {string} Application version string */ version: string;
+    /** @type {string} License type */ license: string;
+    /** @type {Navigation[]} Footer navigation links */ nav: Navigation[];
+    /** @type {Navigation[]} Social sharing links */ share: Navigation[];
+    /** @type {any[]} Available languages for switcher */ langs: any[];
+}
+import { Model } from '@nan0web/types';
+import Navigation from './Navigation.js';

package/types/domain/HeaderModel.d.ts

@@ -0,0 +1,45 @@
+/**
+ * HeaderModel — OLMUI Model-as-Schema
+ * Universal header structure: logo, navigation, language switcher, actions.
+ */
+export default class HeaderModel extends Model {
+    static $id: string;
+    static title: {
+        help: string;
+        placeholder: string;
+        default: string;
+    };
+    static logo: {
+        help: string;
+        placeholder: string;
+        default: string;
+    };
+    static actions: {
+        help: string;
+        type: string;
+        hint: typeof Navigation;
+        default: never[];
+    };
+    static lang: {
+        help: string;
+        type: string;
+        default: null;
+    };
+    static langs: {
+        help: string;
+        type: string;
+        default: never[];
+    };
+    /**
+     * @param {Partial<HeaderModel> | Record<string, any>} data Model input data.
+     * @param {object} [options] Extended options (db, etc.)
+     */
+    constructor(data?: Partial<HeaderModel> | Record<string, any>, options?: object);
+    /** @type {string} Site or app title displayed in the header */ title: string;
+    /** @type {string} Logo image URL or icon name */ logo: string;
+    /** @type {Navigation[]} Header action links (CTA, Sign In, etc.) */ actions: Navigation[];
+    /** @type {any|null} Currently active language */ lang: any | null;
+    /** @type {any[]} Available languages for switcher */ langs: any[];
+}
+import { Model } from '@nan0web/types';
+import Navigation from './Navigation.js';