@lumx/core 4.3.2-alpha.3 → 4.3.2-alpha.30

package/js/components/Icon/Tests.d.ts

@@ -0,0 +1,14 @@
+import { SetupOptions } from '../../../testing';
+import { IconProps } from '.';
+type SetupProps = Partial<IconProps>;
+/**
+ * Mounts the component and returns common DOM elements / data needed in multiple tests further down.
+ */
+export declare const setup: (propsOverride: SetupProps | undefined, { render, ...options }: SetupOptions<IconProps>) => {
+    i: HTMLElement;
+    svg: HTMLElement;
+    path: HTMLElement;
+    props: IconProps;
+};
+declare const _default: (renderOptions: SetupOptions<IconProps>) => void;
+export default _default;

package/js/components/Icon/constants.d.ts

@@ -0,0 +1 @@
+export declare const ICON_SIZES: ("xxs" | "xs" | "s" | "m" | "l" | "xl" | "xxl")[];

package/js/components/Icon/index.d.ts

@@ -0,0 +1,41 @@
+import { ColorWithVariants, ColorVariant } from '../../constants';
+import type { LumxClassName, HasTheme, HasClassName, CommonRef } from '../../types';
+import { ICON_SIZES } from './constants';
+export declare const COMPONENT_NAME = "Icon";
+export declare const IconClassName: LumxClassName<typeof COMPONENT_NAME>;
+export type IconSizes = (typeof ICON_SIZES)[number];
+/**
+ * Defines the props of the component.
+ */
+export interface IconProps extends HasClassName, HasTheme {
+    /** Color variant. */
+    color?: ColorWithVariants;
+    /** Lightened or darkened variant of the selected icon color. */
+    colorVariant?: ColorVariant;
+    /** Whether the icon has a shape. */
+    hasShape?: boolean;
+    /**
+     * Icon (SVG path) draw code (`d` property of the `<path>` SVG element).
+     * See https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths
+     */
+    icon: string;
+    /** Size variant. */
+    size?: IconSizes;
+    /** Sets an alternative text on the svg. Will set an `img` role to the svg. */
+    alt?: string;
+    /** Vertical alignment of the icon (only applies for icons nested in Text/Heading). */
+    verticalAlign?: null | 'middle';
+    /** reference to the root element */
+    ref?: CommonRef;
+}
+/**
+ * Icon component.
+ *
+ * @param  props Component props.
+ */
+export declare const Icon: {
+    (props: IconProps): import("react").JSX.Element;
+    displayName: string;
+    className: "lumx-icon";
+    defaultProps: Partial<IconProps>;
+};

package/js/components/InputHelper/Stories.d.ts

@@ -0,0 +1,43 @@
+import { Kind } from '@lumx/core/js/constants';
+import type { SetupStoriesOptions } from '@lumx/core/stories/types';
+/**
+ * Setup InputHelper stories for a specific framework (React or Vue).
+ * This function creates all the stories with the appropriate decorators.
+ * Framework-specific render functions or args can be injected via `overrides`.
+ */
+export declare function setup({ component, render, decorators: { withCombinations }, }: SetupStoriesOptions<{
+    decorators: 'withCombinations';
+}>): {
+    meta: {
+        component: any;
+        render: any;
+        argTypes: {
+            kind: {
+                control: {
+                    type: "select" | "inline-radio";
+                };
+                options: ("info" | "success" | "warning" | "error")[];
+                mapping: Record<string, "info" | "success" | "warning" | "error"> | undefined;
+            };
+        };
+        args: {
+            children: string;
+            kind?: Kind | undefined;
+            ref?: import("../../types").CommonRef;
+            id?: string | undefined;
+            className?: string | undefined;
+            theme?: import("@lumx/core/js/constants").Theme | undefined;
+        };
+    };
+    /** Default input helper */
+    Default: {};
+    /** All `kind` variants */
+    AllKinds: {
+        argTypes: {
+            kind: {
+                control: boolean;
+            };
+        };
+        decorators: ((story: any, context: any) => any)[];
+    };
+};

package/js/components/InputHelper/Tests.d.ts

@@ -0,0 +1,12 @@
+import { SetupOptions } from '../../../testing';
+import { InputHelperProps } from '.';
+type SetupProps = Partial<InputHelperProps>;
+/**
+ * Mounts the component and returns common DOM elements / data needed in multiple tests further down.
+ */
+export declare const setup: (propsOverride: SetupProps | undefined, { render, ...options }: SetupOptions<InputHelperProps>) => {
+    helper: HTMLElement;
+    props: InputHelperProps;
+};
+declare const _default: (renderOptions: SetupOptions<InputHelperProps>) => void;
+export default _default;

package/js/components/InputHelper/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const INPUT_HELPER_CONFIGURATION: Record<string, {
+    color: string;
+}>;

package/js/components/InputHelper/index.d.ts

@@ -0,0 +1,26 @@
+import { Kind } from '../../constants';
+import type { LumxClassName, HasTheme, JSXElement, HasClassName, CommonRef } from '../../types';
+export declare const COMPONENT_NAME = "InputHelper";
+export declare const InputHelperClassName: LumxClassName<typeof COMPONENT_NAME>;
+/**
+ * Defines the props of the component.
+ */
+export interface InputHelperProps extends HasClassName, HasTheme {
+    /** Helper content. */
+    children: JSXElement;
+    /** Helper variant. */
+    kind?: Kind;
+    /** ref to the root element `p` */
+    ref?: CommonRef;
+    /** id for the input helper */
+    id?: string;
+}
+/**
+ * InputHelper component.
+ */
+export declare function InputHelper(props: InputHelperProps): import("react").JSX.Element;
+export declare namespace InputHelper {
+    var displayName: string;
+    var className: "lumx-input-helper";
+    var defaultProps: Partial<InputHelperProps>;
+}

package/js/components/InputLabel/Stories.d.ts

@@ -0,0 +1,34 @@
+import type { SetupStoriesOptions } from '@lumx/core/stories/types';
+/**
+ * Setup InputLabel stories for a specific framework (React or Vue).
+ * This function creates all the stories with the appropriate decorators.
+ * Framework-specific render functions or args can be injected via `overrides`.
+ */
+export declare function setup({ component, render }: SetupStoriesOptions): {
+    meta: {
+        component: any;
+        render: any;
+        args: {
+            children: string;
+        };
+        argTypes: {
+            isRequired: {
+                control: string;
+            };
+        };
+    };
+    /** Default input label */
+    Default: {};
+    /** Required input label */
+    IsRequired: {
+        args: {
+            isRequired: boolean;
+        };
+    };
+    /** Default input label with custom typography */
+    WithCustomTypography: {
+        args: {
+            typography: "subtitle1";
+        };
+    };
+};

package/js/components/InputLabel/Tests.d.ts

@@ -0,0 +1,12 @@
+import { SetupOptions } from '../../../testing';
+import { InputLabelProps } from '.';
+type SetupProps = Partial<InputLabelProps>;
+/**
+ * Mounts the component and returns common DOM elements / data needed in multiple tests further down.
+ */
+export declare const setup: (propsOverride: SetupProps | undefined, { render, ...options }: SetupOptions<InputLabelProps>) => {
+    label: HTMLElement;
+    props: InputLabelProps;
+};
+declare const _default: (renderOptions: SetupOptions<InputLabelProps>) => void;
+export default _default;

package/js/components/InputLabel/index.d.ts

@@ -0,0 +1,25 @@
+import { LumxClassName, HasTheme, JSXElement, HasClassName, CommonRef } from '../../types';
+import { Typography } from '../../constants';
+export declare const COMPONENT_NAME = "InputLabel";
+export declare const InputLabelClassName: LumxClassName<typeof COMPONENT_NAME>;
+export interface InputLabelProps extends HasClassName, HasTheme {
+    /** Typography variant. */
+    typography?: Typography;
+    /** Label content. */
+    children: JSXElement;
+    /** Native htmlFor property. */
+    htmlFor: string;
+    /** Whether the component is required or not. */
+    isRequired?: boolean;
+    /** ref to the root element */
+    ref?: CommonRef;
+}
+/**
+ * InputLabel component.
+ */
+export declare function InputLabel(props: InputLabelProps): import("react").JSX.Element;
+export declare namespace InputLabel {
+    var displayName: string;
+    var className: "lumx-input-label";
+    var defaultProps: Partial<InputLabelProps>;
+}

package/js/components/Link/Stories.d.ts

@@ -0,0 +1,93 @@
+import type { SetupStoriesOptions } from '@lumx/core/stories/types';
+import { ColorVariant } from '@lumx/core/js/constants';
+/**
+ * Setup Link stories for a specific framework (React or Vue).
+ * This function creates all the stories with the appropriate decorators.
+ * Framework-specific render functions or args can be injected via `overrides`.
+ */
+export declare function setup({ component, render, decorators: { withCombinations }, }: SetupStoriesOptions<{
+    decorators: 'withCombinations';
+}>): {
+    meta: {
+        component: any;
+        render: any;
+        argTypes: {
+            onClick: {
+                action: boolean;
+            };
+            typography: {
+                control: string;
+            };
+        };
+        args: {
+            label: string;
+            color?: import("@lumx/core/js/constants").ColorWithVariants | undefined;
+            colorVariant?: ColorVariant | undefined;
+            href?: string | undefined;
+            leftIcon?: string | undefined;
+            as?: string | any;
+            rightIcon?: string | undefined;
+            target?: string | undefined;
+            typography?: string | undefined;
+            onClick?: ((event: any) => void) | undefined;
+            ref?: import("../../types").CommonRef;
+            theme?: import("@lumx/core/js/constants").Theme | undefined;
+            className?: string | undefined;
+            'aria-disabled'?: import("../../types/Booleanish").Booleanish | undefined;
+            isDisabled?: boolean | undefined;
+            disabled?: boolean | undefined;
+        };
+    };
+    /** Default link */
+    Default: {
+        args: {
+            href: string;
+            target: string;
+        };
+    };
+    /** Link as button */
+    AsButton: {
+        args: {
+            label: string;
+        };
+    };
+    /** With typography */
+    WithTypography: {
+        args: {
+            href: string;
+            typography: string;
+        };
+    };
+    /** With color */
+    WithColor: {
+        args: {
+            href: string;
+            color: "primary";
+            colorVariant: "D1";
+        };
+    };
+    /** Disabled states */
+    Disabled: {
+        argTypes: {
+            isDisabled: {
+                control: boolean;
+            };
+            'aria-disabled': {
+                control: boolean;
+            };
+        };
+        args: {
+            label: string;
+        };
+        decorators: ((story: any, context: any) => any)[];
+    };
+    /** All states */
+    AllStates: {
+        argTypes: {
+            isDisabled: {
+                control: boolean;
+            };
+        };
+        decorators: ((story: any, context: any) => any)[];
+    };
+};

package/js/components/Link/Tests.d.ts

@@ -0,0 +1,15 @@
+import { SetupOptions } from '../../../testing';
+import { LinkProps } from '.';
+type SetupProps = Partial<LinkProps>;
+/**
+ * Mounts the component and returns common DOM elements / data needed in multiple tests further down.
+ */
+export declare const setup: (propsOverride: SetupProps | undefined, { render, ...options }: SetupOptions<LinkProps>) => {
+    link: HTMLElement;
+    rightIcon: HTMLElement | null;
+    leftIcon: HTMLElement | null;
+    content: HTMLElement | null;
+    props: LinkProps;
+};
+declare const _default: (renderOptions: SetupOptions<LinkProps>) => void;
+export default _default;

package/js/components/Link/index.d.ts

@@ -0,0 +1,54 @@
+import { ColorVariant, ColorWithVariants } from '@lumx/core/js/constants';
+import type { JSXElement, LumxClassName, HasTheme, HasClassName, CommonRef, HasAriaDisabled, HasDisabled } from '../../types';
+/**
+ * Defines the props of the component.
+ */
+export interface LinkProps extends HasTheme, HasClassName, HasAriaDisabled, HasDisabled {
+    /** Link label content. */
+    label?: JSXElement;
+    /** Color variant. */
+    color?: ColorWithVariants;
+    /** Lightened or darkened variant of the selected icon color. */
+    colorVariant?: ColorVariant;
+    /** Link href. */
+    href?: string;
+    /**
+     * Left icon (SVG path).
+     * @deprecated Instead, simply nest `<Icon />` in the label
+     */
+    leftIcon?: string;
+    /** Element type or custom component for the link. */
+    as?: string | any;
+    /**
+     * Right icon (SVG path).
+     * @deprecated Instead, simply nest `<Icon />` in the label
+     */
+    rightIcon?: string;
+    /** Link target. */
+    target?: string;
+    /** Typography variant. */
+    typography?: string;
+    /** Click handler. */
+    onClick?: (event: any) => void;
+    /** Reference to the root element. */
+    ref?: CommonRef;
+}
+/**
+ * Component display name.
+ */
+export declare const COMPONENT_NAME = "Link";
+/**
+ * Component default class name and class prefix.
+ */
+export declare const CLASSNAME: LumxClassName<typeof COMPONENT_NAME>;
+/**
+ * Component default props.
+ */
+export declare const DEFAULT_PROPS: Partial<LinkProps>;
+/**
+ * Link component (Core UI).
+ *
+ * @param  props Component props.
+ * @return JSX element.
+ */
+export declare const Link: (props: LinkProps) => import("react").JSX.Element;

package/js/components/Message/Stories.d.ts

@@ -0,0 +1,119 @@
+import type { SetupStoriesOptions } from '@lumx/core/stories/types';
+/**
+ * Setup Message stories for a specific framework (React or Vue).
+ * This function creates all the stories with the appropriate decorators.
+ * Framework-specific render functions or args can be injected via `overrides`.
+ */
+export declare function setup({ component, render, decorators: { withCombinations }, overrides, }: SetupStoriesOptions<{
+    overrides: 'ClosableMessage';
+    decorators: 'withCombinations';
+}>): {
+    meta: {
+        component: any;
+        render: any;
+        argTypes: {
+            kind: {
+                control: {
+                    type: "select" | "inline-radio";
+                };
+                options: ("info" | "success" | "warning" | "error")[];
+                mapping: Record<string, "info" | "success" | "warning" | "error"> | undefined;
+            };
+            hasBackground: {
+                control: string;
+            };
+            icon: {
+                control: {
+                    type: string;
+                };
+                options: {
+                    undefined: undefined;
+                    mdiAbTesting: string;
+                    mdiAbjadArabic: string;
+                    mdiAccount: string;
+                    mdiAccountBox: string;
+                    mdiAlert: string;
+                    mdiAlertCircle: string;
+                    mdiArrowDown: string;
+                    mdiArrowUp: string;
+                    mdiAtom: string;
+                    mdiBee: string;
+                    mdiBell: string;
+                    mdiBullhornOutline: string;
+                    mdiCheck: string;
+                    mdiCheckCircle: string;
+                    mdiChevronDown: string;
+                    mdiChevronLeft: string;
+                    mdiChevronRight: string;
+                    mdiChevronUp: string;
+                    mdiClose: string;
+                    mdiCloseCircle: string;
+                    mdiDelete: string;
+                    mdiDotsHorizontal: string;
+                    mdiDragVertical: string;
+                    mdiEarth: string;
+                    mdiEmail: string;
+                    mdiEye: string;
+                    mdiFileEdit: string;
+                    mdiFlag: string;
+                    mdiFolder: string;
+                    mdiFolderGoogleDrive: string;
+                    mdiFoodApple: string;
+                    mdiGoogleCirclesExtended: string;
+                    mdiHeart: string;
+                    mdiHome: string;
+                    mdiImageBroken: string;
+                    mdiInformation: string;
+                    mdiLink: string;
+                    mdiMagnifyMinusOutline: string;
+                    mdiMagnifyPlusOutline: string;
+                    mdiMenuDown: string;
+                    mdiMessageTextOutline: string;
+                    mdiMinus: string;
+                    mdiOpenInNew: string;
+                    mdiPauseCircleOutline: string;
+                    mdiPencil: string;
+                    mdiPlay: string;
+                    mdiPlayCircleOutline: string;
+                    mdiPlus: string;
+                    mdiRadioboxBlank: string;
+                    mdiRadioboxMarked: string;
+                    mdiReply: string;
+                    mdiSend: string;
+                    mdiStar: string;
+                    mdiTextBox: string;
+                    mdiTextBoxPlus: string;
+                    mdiTram: string;
+                    mdiTranslate: string;
+                    mdiViewList: string;
+                };
+            };
+        };
+        args: {
+            children: string;
+        };
+    };
+    /** Default message */
+    Default: {};
+    /** All `kind` variants */
+    AllKinds: {
+        decorators: ((story: any, context: any) => any)[];
+    };
+    /** All `kind` variants with `hasBackground` */
+    AllKindsWithBackground: {
+        args: {
+            hasBackground: boolean;
+        };
+        decorators: ((story: any, context: any) => any)[];
+    };
+    /** With custom icon */
+    CustomIcon: {
+        args: {
+            icon: string;
+        };
+    };
+    /** With close button (has background and kind info) */
+    ClosableMessage: {
+        args: any;
+    };
+};

package/js/components/Message/Tests.d.ts

@@ -0,0 +1,14 @@
+import { SetupOptions } from '../../../testing';
+import { MessageProps } from '.';
+type SetupProps = Partial<MessageProps>;
+/**
+ * Mounts the component and returns common DOM elements / data needed in multiple tests further down.
+ */
+export declare const setup: (propsOverride: SetupProps | undefined, { render, ...options }: SetupOptions<MessageProps>) => {
+    message: HTMLElement;
+    icon: HTMLElement | null;
+    closeButton: HTMLElement | null;
+    props: MessageProps;
+};
+declare const _default: (renderOptions: SetupOptions<MessageProps>) => void;
+export default _default;

package/js/components/Message/index.d.ts

@@ -0,0 +1,75 @@
+import { Kind } from '../../constants';
+import type { JSXElement, LumxClassName, HasClassName, CommonRef } from '../../types';
+/**
+ * Defines the props of the component.
+ */
+export interface MessageProps extends HasClassName {
+    /** Content. */
+    children?: JSXElement;
+    /** Whether the message has a background or not. */
+    hasBackground?: boolean;
+    /** Message variant. */
+    kind?: Kind;
+    /** Message custom icon SVG path. */
+    icon?: string;
+    /** Reference to the message container element. */
+    ref?: CommonRef;
+    /**
+     * Displays a close button.
+     *
+     * NB: only available if `kind === 'info' && hasBackground === true`
+     */
+    closeButtonProps?: {
+        /** The callback called when the button is clicked */
+        onClick: () => void;
+        /** The label of the close button. */
+        label: string;
+    };
+}
+/**
+ * Component display name.
+ */
+export declare const COMPONENT_NAME = "Message";
+/**
+ * Component default class name and class prefix.
+ */
+export declare const CLASSNAME: LumxClassName<typeof COMPONENT_NAME>;
+export declare const block: {
+    (additionalClasses: import("classnames/types").ClassValue[]): string;
+    (modifiers?: import("../../utils/classNames/bem/modifier").Modifier, additionalClasses?: import("classnames/types").ClassValue[]): string;
+}, element: {
+    (elem: string, additionalClasses: import("classnames/types").ClassValue[]): string;
+    (elem: string, modifiers?: import("../../utils/classNames/bem/modifier").Modifier, additionalClasses?: import("classnames/types").ClassValue[]): string;
+};
+/**
+ * Associative map from message kind to color and icon.
+ */
+export declare const CONFIG: {
+    error: {
+        color: "red";
+        icon: string;
+    };
+    info: {
+        color: "blue";
+        icon: string;
+    };
+    success: {
+        color: "green";
+        icon: string;
+    };
+    warning: {
+        color: "yellow";
+        icon: string;
+    };
+};
+/**
+ * Message component.
+ *
+ * @param  props Component props.
+ * @return JSX element.
+ */
+export declare const Message: {
+    (props: MessageProps): import("react").JSX.Element;
+    displayName: string;
+    className: "lumx-message";
+};

package/js/components/RadioButton/Stories.d.ts

@@ -0,0 +1,77 @@
+import type { SetupStoriesOptions } from '@lumx/core/stories/types';
+/**
+ * Setup RadioButton stories for a specific framework (React or Vue).
+ * This function creates all the stories with the appropriate decorators.
+ * Framework-specific render functions or args can be injected via `overrides`.
+ */
+export declare function setup({ component, render, decorators: { withCombinations }, }: SetupStoriesOptions<{
+    decorators: 'withCombinations';
+}>): {
+    meta: {
+        component: any;
+        render: any;
+        argTypes: {
+            onChange: {
+                action: boolean;
+            };
+            name: {
+                control: boolean;
+            };
+            value: {
+                control: boolean;
+            };
+        };
+        args: {
+            isChecked: boolean;
+            name: string;
+            value: string;
+            helper?: string | undefined;
+            id?: string | undefined;
+            label?: import("react").ReactNode;
+            inputProps?: Record<string, any> | undefined;
+            inputRef?: import("../../types").CommonRef;
+            inputId?: string | undefined;
+            onChange?: ((value?: string, name?: string, event?: any) => void) | undefined;
+            ref?: import("../../types").CommonRef;
+            theme?: import("../../constants").Theme | undefined;
+            className?: string | undefined;
+            'aria-disabled'?: import("../../types/Booleanish").Booleanish | undefined;
+            isDisabled?: boolean | undefined;
+            disabled?: boolean | undefined;
+            checked?: boolean | undefined;
+        };
+    };
+    /** Default radio button */
+    Default: {};
+    /** With label and helper */
+    LabelAndHelper: {
+        argTypes: {
+            label: {
+                control: string;
+            };
+            helper: {
+                control: string;
+            };
+        };
+        args: {
+            label: string;
+            helper: string;
+        };
+    };
+    /** Disabled */
+    Disabled: {
+        argTypes: {
+            isDisabled: {
+                control: boolean;
+            };
+            'aria-disabled': {
+                control: boolean;
+            };
+        };
+        args: {
+            label: string;
+            helper: string;
+        };
+        decorators: ((story: any, context: any) => any)[];
+    };
+};