@nan0web/ui 1.12.2 → 3.1.0

package/types/Theme/atoms/TextArea.d.ts

@@ -0,0 +1,17 @@
+declare const _default: {
+    height: string;
+    borderRadius: string;
+    borderWidth: string;
+    borderColor: string;
+    fontSize: string;
+    paddingX: string;
+    paddingY: string;
+    fontFamily: string;
+};
+export default _default;
+/**
+ * Theme definition for TextArea atom.
+ */
+export type TextAreaTheme = {
+    height: string;
+};

package/types/Theme/atoms/Typography.d.ts

@@ -0,0 +1,47 @@
+declare const _default: {
+    variants: {
+        h1: {
+            fontSize: string;
+            fontWeight: string;
+        };
+        h2: {
+            fontSize: string;
+            fontWeight: string;
+        };
+        h3: {
+            fontSize: string;
+            fontWeight: string;
+        };
+        h4: {
+            fontSize: string;
+            fontWeight: string;
+        };
+        h5: {
+            fontSize: string;
+            fontWeight: string;
+        };
+        h6: {
+            fontSize: string;
+            fontWeight: string;
+        };
+        body: {
+            fontSize: string;
+            fontWeight: string;
+        };
+        small: {
+            fontSize: string;
+            fontWeight: string;
+        };
+        caption: {
+            fontSize: string;
+            fontWeight: string;
+        };
+    };
+};
+export default _default;
+/**
+ * Theme definition for Typography atom.
+ */
+export type TypographyTheme = {
+    variants: any;
+};

package/types/Theme/atoms/index.d.ts

@@ -0,0 +1,10 @@
+import Avatar from './Avatar.js';
+import Badge from './Badge.js';
+import Button from './Button.js';
+import Checkbox from './Checkbox.js';
+import Input from './Input.js';
+import Radio from './Radio.js';
+import Select from './Select.js';
+import TextArea from './TextArea.js';
+import Typography from './Typography.js';
+export { Avatar, Badge, Button, Checkbox, Input, Radio, Select, TextArea, Typography };

package/types/Theme/createTheme.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Creates a theme instance with merged configuration.
+ *
+ * @param {Partial<import('./Theme.js').ThemeConfig>} overrides
+ * @returns {import('./Theme.js').ThemeConfig}
+ */
+export function createTheme(overrides?: Partial<import("./Theme.js").ThemeConfig>): import("./Theme.js").ThemeConfig;

package/types/Theme/index.d.ts

@@ -0,0 +1,10 @@
+export default Theme;
+import Theme from './Theme.js';
+import CustomTheme from './CustomTheme.js';
+import { getUserTheme } from './CustomTheme.js';
+import AppTheme from './AppTheme.js';
+import DarkLightTheme from './DarkLightTheme.js';
+import HighContrastTheme from './presets/HighContrastTheme.js';
+import NightTheme from './presets/NightTheme.js';
+import { createTheme } from './createTheme.js';
+export { Theme, CustomTheme, getUserTheme, AppTheme, DarkLightTheme, HighContrastTheme, NightTheme, createTheme };

package/types/Theme/molecules/Card.d.ts

@@ -0,0 +1,18 @@
+declare const _default: {
+    borderRadius: string;
+    boxShadow: string;
+    padding: string;
+    backgroundColor: string;
+    borderColor: string;
+};
+export default _default;
+/**
+ * Theme definition for Card molecule.
+ */
+export type CardTheme = {
+    borderRadius: string;
+    boxShadow: string;
+    padding: string;
+    backgroundColor: string;
+    borderColor: string;
+};

package/types/Theme/molecules/index.d.ts

@@ -0,0 +1,2 @@
+export { Card };
+import Card from './Card.js';

package/types/Theme/organisms/Modal.d.ts

@@ -0,0 +1,18 @@
+declare const _default: {
+    overlayBackground: string;
+    borderRadius: string;
+    boxShadow: string;
+    padding: string;
+    backgroundColor: string;
+};
+export default _default;
+/**
+ * Theme definition for Modal organism.
+ */
+export type ModalTheme = {
+    overlayBackground: string;
+    borderRadius: string;
+    boxShadow: string;
+    padding: string;
+    backgroundColor: string;
+};

package/types/Theme/organisms/index.d.ts

@@ -0,0 +1,2 @@
+export { Modal };
+import Modal from './Modal.js';

package/types/Theme/presets/HighContrastTheme.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("../Theme.js").ThemeConfig;
+export default _default;

package/types/Theme/presets/NightTheme.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("../Theme.js").ThemeConfig;
+export default _default;

package/types/Theme/presets/index.d.ts

@@ -0,0 +1,3 @@
+import HighContrastTheme from './HighContrastTheme.js';
+import NightTheme from './NightTheme.js';
+export { HighContrastTheme, NightTheme };

package/types/Theme/tokens.d.ts

@@ -0,0 +1,119 @@
+export namespace tokens {
+    export namespace space {
+        let xs: string;
+        let sm: string;
+        let md: string;
+        let lg: string;
+        let xl: string;
+    }
+    export namespace radius {
+        export let none: string;
+        let sm_1: string;
+        export { sm_1 as sm };
+        let md_1: string;
+        export { md_1 as md };
+        let lg_1: string;
+        export { lg_1 as lg };
+        export let full: string;
+    }
+    export namespace border {
+        namespace width {
+            let sm_2: string;
+            export { sm_2 as sm };
+            let md_2: string;
+            export { md_2 as md };
+        }
+        namespace color {
+            let _default: string;
+            export { _default as default };
+            export let muted: string;
+            export let error: string;
+        }
+    }
+    export namespace color_1 {
+        export let text: string;
+        export let background: string;
+        export let primary: string;
+        export let success: string;
+        export let warning: string;
+        let error_1: string;
+        export { error_1 as error };
+    }
+    export { color_1 as color };
+    export namespace font {
+        let family: string;
+        namespace size {
+            let xs_1: string;
+            export { xs_1 as xs };
+            let sm_3: string;
+            export { sm_3 as sm };
+            export let base: string;
+            let lg_2: string;
+            export { lg_2 as lg };
+            let xl_1: string;
+            export { xl_1 as xl };
+        }
+        namespace weight {
+            let normal: string;
+            let medium: string;
+            let bold: string;
+        }
+    }
+    export namespace shadow {
+        let sm_4: string;
+        export { sm_4 as sm };
+        let md_3: string;
+        export { md_3 as md };
+        let lg_3: string;
+        export { lg_3 as lg };
+    }
+    export namespace breakpoint {
+        let xs_2: string;
+        export { xs_2 as xs };
+        let sm_5: string;
+        export { sm_5 as sm };
+        let md_4: string;
+        export { md_4 as md };
+        let lg_4: string;
+        export { lg_4 as lg };
+        let xl_2: string;
+        export { xl_2 as xl };
+        export let xxl: string;
+    }
+    export namespace container {
+        let sm_6: string;
+        export { sm_6 as sm };
+        let md_5: string;
+        export { md_5 as md };
+        let lg_5: string;
+        export { lg_5 as lg };
+        let xl_3: string;
+        export { xl_3 as xl };
+        let xxl_1: string;
+        export { xxl_1 as xxl };
+    }
+    export namespace zIndex {
+        let dropdown: number;
+        let sticky: number;
+        let fixed: number;
+        let modalBackdrop: number;
+        let modal: number;
+        let popover: number;
+        let tooltip: number;
+    }
+    export let opacity: {
+        0: string;
+        10: string;
+        25: string;
+        50: string;
+        75: string;
+        90: string;
+        100: string;
+    };
+    export namespace transition {
+        export let fast: string;
+        let medium_1: string;
+        export { medium_1 as medium };
+        export let slow: string;
+    }
+}

package/types/core/Intent.d.ts

@@ -44,11 +44,14 @@ export function ask(field: string, schema: object | Function): AskIntent;
  * @returns {ProgressIntent}
  */
 export function progress(message: string, value?: number, optionsOrTotalOrId?: ProgressOptions | number | string, id?: string): ProgressIntent;
-export function log(level: any, message: any, data?: {}): {
-    type: string;
-    level: any;
-    message: any;
-};
+/**
+ * Lgs a message if level is greater or equal the current view level.
+ * @param {LogLevel} level
+ * @param {string} message
+ * @param {object} [data={}]
+ * @returns {LogIntent}
+ */
+export function log(level: LogLevel, message: string, data?: object): LogIntent;
 /**
  * Create a render intent.
  * @param {string} component - Component name (e.g. 'App.Layout.Header').
@@ -115,7 +118,7 @@ export function agent(task: string, context?: AgentContext): AgentIntent;
 /**
  * @typedef {'info' | 'warn' | 'error' | 'success'} ShowLevel
  */
-/** @typedef {ShowLevel} LogLevel */
+/** @typedef {ShowLevel | 'debug'} LogLevel */
 /**
  * Model emits a show message. No response expected.
  * Message MUST come from the Model (i18n static field value).
@@ -333,7 +336,7 @@ export type ProgressIntent = {
     options?: ProgressOptions | undefined;
 };
 export type ShowLevel = "info" | "warn" | "error" | "success";
-export type LogLevel = ShowLevel;
+export type LogLevel = ShowLevel | "debug";
 /**
  * Model emits a show message. No response expected.
  * Message MUST come from the Model (i18n static field value).

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

@@ -14,6 +14,9 @@
  *
  * @class UiMessage
  * @extends Message
+ * @property {Record<string, any>} head - Message head.
+ * @property {boolean} isValid - True if message is valid.
+ * @property {Date} time - Creation timestamp.
  *
  * @example
  * class UserLoginMessage extends UiMessage {

package/types/core/OutputAdapter.d.ts

@@ -9,10 +9,10 @@ declare class OutputAdapter extends Event {
     /**
      * Renders a message to the user.
      *
-     * @param {OutputMessage|FormMessage} message - Message to render.
+     * @param {object} message - Message to render.
      * @throws {Error} If not overridden by a subclass.
      */
-    render(message: OutputMessage | FormMessage): void;
+    render(message: object): void;
     /**
      * Shows progress of a long‑running operation.
      *
@@ -29,5 +29,3 @@ declare class OutputAdapter extends Event {
     stop(): void;
 }
 import Event from '@nan0web/event/oop';
-import OutputMessage from './Message/OutputMessage.js';
-import FormMessage from './Form/Message.js';

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/core/resolvePositionalArgs.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Resolves positional CLI arguments into named model fields.
+ *
+ * Scans a Model class for `static` field descriptors with `positional: true`.
+ * The order of positional fields follows the declaration order of static properties
+ * (guaranteed by JavaScript spec for non-integer keys).
+ *
+ * @example
+ * class MyModel {
+ *   static source = { help: 'Source path', default: '.', positional: true }
+ *   static target = { help: 'Target path', default: 'out', positional: true }
+ *   static quiet  = { help: 'Quiet mode', default: false, type: 'boolean' }
+ * }
+ *
+ * const data = resolvePositionalArgs(MyModel, ['src/', 'dist/'])
+ * // → { source: 'src/', target: 'dist/' }
+ *
+ * @param {typeof Model} ModelClass - The Model class with static field descriptors.
+ * @param {string[]} args - Positional arguments from the CLI (e.g., process.argv positionals).
+ * @param {Object} [existing={}] - Existing named options (take priority over positionals).
+ * @returns {Object} Merged data object with positional args resolved to named fields.
+ */
+export function resolvePositionalArgs(ModelClass: typeof Model, args?: string[], existing?: any): any;
+import { Model } from '@nan0web/types';

package/types/docs/README.md.d.ts

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

package/types/domain/Content.d.ts

@@ -173,9 +173,9 @@ export class Content extends Model {
     };
     /**
      * @param {ContentData | string} [data={}]
-     * @param {import('@nan0web/types').ModelOptions} [options={}]
+     * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
      */
-    constructor(data?: ContentData | string, options?: import("@nan0web/types").ModelOptions);
+    constructor(data?: ContentData | string, options?: Partial<import("@nan0web/types").ModelOptions>);
     /** @type {string|undefined} Content */ content: string | undefined;
     /** @type {Array<Content>|undefined} Children */ children: Array<Content> | undefined;
 }

package/types/domain/Document.d.ts

@@ -20,15 +20,15 @@ export class Document extends Model {
     };
     static langs: {
         type: string;
-        model: any;
+        model: typeof Language;
         help: string;
     };
     /**
      *
      * @param {Partial<Document>} [data]
-     * @param {import('@nan0web/types').ModelOptions} [options]
+     * @param {Partial<import('@nan0web/types').ModelOptions>} [options]
      */
-    constructor(data?: Partial<Document>, options?: import("@nan0web/types").ModelOptions);
+    constructor(data?: Partial<Document>, options?: Partial<import("@nan0web/types").ModelOptions>);
     /** @type {string} Title */ title: string;
     /** @type {Array<Content>} Content */ content: Array<Content>;
     /** @type {Array<Content>} Layout configuration */ $content: Array<Content>;
@@ -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/HeroModel.d.ts

@@ -32,9 +32,9 @@ export class HeroModel extends Model {
     };
     /**
      * @param {Partial<HeroModel | Record<string, any>>} [data={}]
-     * @param {import('@nan0web/types').ModelOptions} [options={}]
+     * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
      */
-    constructor(data?: Partial<HeroModel | Record<string, any>>, options?: import("@nan0web/types").ModelOptions);
+    constructor(data?: Partial<HeroModel | Record<string, any>>, options?: Partial<import("@nan0web/types").ModelOptions>);
     /** @type {string} Top small badge text ior icon */ badge: string;
     /** @type {string} Hero heading */ title: string;
     /** @type {string} Hero secondary text */ subtitle: string;

package/types/domain/ModelAsApp.d.ts

@@ -1,23 +1,67 @@
-/** @typedef {import('@nan0web/types').ModelOptions & { adapter: InputAdapter }} ModelAsAppOptions */
+/**
+ * @typedef {Object} AppOptions
+ * @property {InputAdapter} adapter
+ * @property {string} parentPath
+ * @property {boolean} _isExplicit
+ */
+/** @typedef {import('@nan0web/types').ModelOptions & AppOptions} ModelAsAppOptions */
 /**
  * The model with a run generator.
+ * @property {boolean} help Show help
  */
 export class ModelAsApp extends Model {
+    static help: {
+        help: string;
+        default: boolean;
+    };
+    /**
+     * Execute the model programmatically without a UI adapter.
+     * @param {any} [data]
+     * @param {Partial<ModelAsAppOptions>} [options]
+     * @returns {Promise<any>}
+     */
+    static execute(data?: any, options?: Partial<ModelAsAppOptions>): Promise<any>;
     /**
      * @param {Partial<ModelAsApp> | Record<string, any>} [data={}]
      * @param {Partial<ModelAsAppOptions>} [options={}]
      */
     constructor(data?: Partial<ModelAsApp> | Record<string, any>, options?: Partial<ModelAsAppOptions>);
-    /** @returns {ModelAsAppOptions} */
-    get _(): ModelAsAppOptions;
+    /** @type {boolean} Show help */ help: boolean;
+    _: {
+        adapter: InputAdapter;
+        parentPath: string;
+        _isExplicit: boolean;
+        db: import("@nan0web/db").default | null | undefined;
+        plugins: Record<string, any>;
+        t: import("../../../types/types/utils/TFunction.js").TFunction;
+    };
+    /**
+     * Instantiates a subcommand if the value matches one of the options.
+     * @param {string} key - Field name.
+     * @param {any} val - Current value (string, class, or instance).
+     * @param {any} [data={}] - Data to pass to the new instance.
+     * @returns {any} Instantiated subcommand or original value.
+     */
+    _instantiateSubCommand(key: string, val: any, data?: any): any;
+    /**
+     * Generate help text for the model
+     * @param {string} [parentPath]
+     * @returns {string}
+     */
+    generateHelp(parentPath?: string): string;
     /**
+     * Default execution generator.
+     * Automatically delegates to the first instantiated subcommand field.
+     *
      * @returns {AsyncGenerator<import('@nan0web/ui').Intent, import('@nan0web/ui').ResultIntent, any>}
      */
     run(): AsyncGenerator<import("@nan0web/ui").Intent, import("@nan0web/ui").ResultIntent, any>;
-    #private;
 }
-export type ModelAsAppOptions = import("@nan0web/types").ModelOptions & {
+export type AppOptions = {
     adapter: InputAdapter;
+    parentPath: string;
+    _isExplicit: boolean;
 };
+export type ModelAsAppOptions = import("@nan0web/types").ModelOptions & AppOptions;
 import { Model } from '@nan0web/types';
 import { InputAdapter } from '../core/InputAdapter.js';

package/types/domain/ModelAsApp.story.d.ts

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

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

@@ -6,50 +6,19 @@ export class GalleryCommand extends ModelAsApp {
     static action: {
         type: string;
         help: string;
-        options: (typeof SnapshotAuditor | typeof GalleryRenderIntent)[];
-        default: string;
+        options: (typeof SnapshotAuditor | typeof GalleryRenderCommand)[];
+        default: typeof SnapshotAuditor;
         positional: boolean;
     };
     /**
      * @param {Partial<GalleryCommand> | Record<string, any>} [data={}]
-     * @param {import('@nan0web/types').ModelOptions} [options={}]
+     * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
      */
-    constructor(data?: Partial<GalleryCommand> | Record<string, any>, options?: import("@nan0web/types").ModelOptions);
-    /** @type {string} */ action: string;
+    constructor(data?: Partial<GalleryCommand> | Record<string, any>, options?: Partial<import("@nan0web/types").ModelOptions>);
+    /** @type {typeof SnapshotAuditor | typeof GalleryRenderCommand} */ action: typeof SnapshotAuditor | typeof GalleryRenderCommand;
     /** @type {string[]} */ _positionals: string[];
-    run(): AsyncGenerator<import("../../core/Intent.js").ShowIntent | (import("../../core/Intent.js").AskIntent & {
-        $value?: any;
-        $success?: boolean;
-        $files?: Record<string, string>;
-        $message?: string;
-    }) | (import("../../core/Intent.js").ProgressIntent & {
-        $value?: any;
-        $success?: boolean;
-        $files?: Record<string, string>;
-        $message?: string;
-    }) | (import("../../core/Intent.js").LogIntent & {
-        $value?: any;
-        $success?: boolean;
-        $files?: Record<string, string>;
-        $message?: string;
-    }) | (import("../../core/Intent.js").RenderIntent & {
-        $value?: any;
-        $success?: boolean;
-        $files?: Record<string, string>;
-        $message?: string;
-    }) | (import("../../core/Intent.js").AgentIntent & {
-        $value?: any;
-        $success?: boolean;
-        $files?: Record<string, string>;
-        $message?: string;
-    }) | (import("../../core/Intent.js").ResultIntent & {
-        $value?: any;
-        $success?: boolean;
-        $files?: Record<string, string>;
-        $message?: string;
-    }), any, any>;
 }
 export default GalleryCommand;
 import { ModelAsApp } from '../ModelAsApp.js';
 import SnapshotAuditor from './SnapshotAuditor.js';
-import GalleryRenderIntent from './GalleryRenderIntent.js';
+import GalleryRenderCommand from './GalleryRenderCommand.js';

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

@@ -0,0 +1,27 @@
+export class GalleryRenderCommand extends ModelAsApp {
+    static alias: string;
+    static UI: {
+        rendering: string;
+        success: string;
+        failed: string;
+    };
+    static dataDir: {
+        type: string;
+        default: string;
+        help: string;
+    };
+    static dir: {
+        type: string;
+        default: string;
+        help: string;
+    };
+    /**
+     * @param {Partial<GalleryRenderCommand> | Record<string, any>} [data={}]
+     * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
+     */
+    constructor(data?: Partial<GalleryRenderCommand> | Record<string, any>, options?: Partial<import("@nan0web/types").ModelOptions>);
+    /** @type {string} */ dataDir: string;
+    /** @type {string} */ dir: string;
+}
+export default GalleryRenderCommand;
+import { ModelAsApp } from '../index.js';

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';