@nan0web/ui 1.12.3 → 3.1.1

package/types/Theme/CustomTheme.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @typedef {{ atoms?: object, molecules?: object, organisms?: object }} UserThemeConfig
+ */
+/**
+ * Returns selected or custom user theme.
+ * @param {string | UserThemeConfig} themeNameOrConfig
+ * @returns {import('./Theme.js').ThemeConfig}
+ */
+export function getUserTheme(themeNameOrConfig: string | UserThemeConfig): import("./Theme.js").ThemeConfig;
+/**
+ * Custom user theme.
+ * Extends the base Theme to allow passing configuration during instantiation.
+ * @param {UserThemeConfig} config
+ * @returns {import('./Theme.js').ThemeConfig}
+ */
+export default function CustomTheme(config: UserThemeConfig): import("./Theme.js").ThemeConfig;
+export type UserThemeConfig = {
+    atoms?: object;
+    molecules?: object;
+    organisms?: object;
+};

package/types/Theme/DarkLightTheme.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Theme that automatically switches between light/dark modes.
+ */
+export default class DarkLightTheme {
+    /** @type {Object} */
+    static light: any;
+    /** @type {Object} */
+    static dark: any;
+    /** @type {string} */
+    static current: string;
+    /**
+     * Gets active theme (light, dark, or system preference).
+     * @returns {Object}
+     */
+    static getActiveTheme(): any;
+}

package/types/Theme/Theme.d.ts

@@ -0,0 +1,18 @@
+declare const _default: {
+    atoms: typeof atoms;
+    molecules: typeof molecules;
+    organisms: typeof organisms;
+};
+export default _default;
+/**
+ * Universal UI theme foundation.
+ * Holds atoms, molecules, and organisms styling configs.
+ */
+export type ThemeConfig = {
+    atoms: Partial<typeof atoms>;
+    molecules: typeof molecules;
+    organisms: typeof organisms;
+};
+import * as atoms from './atoms/index.js';
+import * as molecules from './molecules/index.js';
+import * as organisms from './organisms/index.js';

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

@@ -0,0 +1,14 @@
+declare const _default: {
+    size: string;
+    borderRadius: string;
+    border: string;
+};
+export default _default;
+/**
+ * Theme definition for Avatar atom.
+ */
+export type AvatarTheme = {
+    size: string;
+    borderRadius: string;
+    border: string;
+};

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

@@ -0,0 +1,22 @@
+declare const _default: {
+    borderRadius: string;
+    fontSize: string;
+    paddingX: string;
+    paddingY: string;
+    fontWeight: string;
+    backgroundColor: string;
+    color: string;
+};
+export default _default;
+/**
+ * Theme definition for Badge atom.
+ */
+export type BadgeTheme = {
+    borderRadius: string;
+    fontSize: string;
+    paddingX: string;
+    paddingY: string;
+    fontWeight: string;
+    backgroundColor: string;
+    color: string;
+};

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

@@ -0,0 +1,144 @@
+declare const _default: {
+    color: string;
+    background: string;
+    shadow: string;
+    hoverBackground: string;
+    solid: {
+        primary: {
+            background: string;
+            color: string;
+            border: string;
+        };
+        secondary: {
+            background: string;
+            color: string;
+            border: string;
+        };
+        success: {
+            background: string;
+            color: string;
+            border: string;
+        };
+        warning: {
+            background: string;
+            color: string;
+            border: string;
+        };
+        danger: {
+            background: string;
+            color: string;
+            border: string;
+        };
+        info: {
+            background: string;
+            color: string;
+            border: string;
+        };
+        light: {
+            background: string;
+            color: string;
+            border: string;
+        };
+        dark: {
+            background: string;
+            color: string;
+            border: string;
+        };
+        link: {
+            background: string;
+            color: string;
+            border: string;
+        };
+    };
+    outline: {
+        primary: {
+            background: string;
+            color: string;
+            border: string;
+        };
+        secondary: {
+            background: string;
+            color: string;
+            border: string;
+        };
+        success: {
+            background: string;
+            color: string;
+            border: string;
+        };
+        warning: {
+            background: string;
+            color: string;
+            border: string;
+        };
+        danger: {
+            background: string;
+            color: string;
+            border: string;
+        };
+        info: {
+            background: string;
+            color: string;
+            border: string;
+        };
+        light: {
+            background: string;
+            color: string;
+            border: string;
+        };
+        dark: {
+            background: string;
+            color: string;
+            border: string;
+        };
+    };
+    size: {
+        sm: {
+            fontSize: string;
+            paddingX: string;
+            paddingY: string;
+        };
+        md: {
+            fontSize: string;
+            paddingX: string;
+            paddingY: string;
+        };
+    };
+    animation: {
+        transition: string;
+        hoverAdjust: number;
+        activeAdjust: number;
+        focusScale: number;
+        activeScale: number;
+        disabledOpacity: number;
+    };
+    borderColor: string;
+    borderRadius: string;
+    borderWidth: string;
+    fontSize: string;
+    paddingX: string;
+    paddingY: string;
+    fontFamily: string;
+};
+export default _default;
+/**
+ * Theme definition for Button atom.
+ * Inherits common properties from Input and defines colour and shadow.
+ */
+export type ButtonTheme = {
+    color: string;
+    background: string;
+    shadow: string;
+    hoverBackground: string;
+    solid: any;
+    outline: any;
+    size: any;
+    animation: any;
+    borderColor: string;
+    borderRadius: string;
+    borderWidth: string;
+    fontSize: string;
+    paddingX: string;
+    paddingY: string;
+    fontFamily: string;
+};

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

@@ -0,0 +1,20 @@
+declare const _default: {
+    size: string;
+    borderColor: string;
+    borderRadius: string;
+    borderWidth: string;
+    backgroundColor: string;
+    checkedColor: string;
+};
+export default _default;
+/**
+ * Theme definition for Checkbox atom.
+ */
+export type CheckboxTheme = {
+    size: string;
+    borderColor: string;
+    borderRadius: string;
+    borderWidth: string;
+    backgroundColor: string;
+    checkedColor: string;
+};

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

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

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

@@ -0,0 +1,20 @@
+declare const _default: {
+    size: string;
+    borderColor: string;
+    borderRadius: string;
+    borderWidth: string;
+    backgroundColor: string;
+    checkedColor: string;
+};
+export default _default;
+/**
+ * Theme definition for Radio atom.
+ */
+export type RadioTheme = {
+    size: string;
+    borderColor: string;
+    borderRadius: string;
+    borderWidth: string;
+    backgroundColor: string;
+    checkedColor: string;
+};

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

@@ -0,0 +1,15 @@
+declare const _default: {
+    borderRadius: string;
+    borderWidth: string;
+    borderColor: string;
+    fontSize: string;
+    paddingX: string;
+    paddingY: string;
+    fontFamily: string;
+};
+export default _default;
+/**
+ * Theme definition for Select atom.
+ * Inherits all properties from InputTheme.
+ */
+export type SelectTheme = import("./Input.js").InputTheme;

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