@lumx/core 4.17.1-alpha.2 → 4.17.1-alpha.3

package/js/components/List/ListItemActionTests.d.ts

@@ -1,11 +0,0 @@
-import { SetupOptions } from '../../../testing';
-/**
- * Mounts the component and returns common DOM elements / data needed in multiple tests further down.
- */
-export declare const setup: (propsOverride: any | undefined, { render, screen, ...options }: SetupOptions<any>) => {
-    props: any;
-    listItemAction: HTMLElement;
-    screen: import("@testing-library/dom").Screen;
-};
-declare const _default: (renderOptions: SetupOptions<any>) => void;
-export default _default;

package/js/components/List/ListItemStories.d.ts

@@ -1,53 +0,0 @@
-import type { SetupStoriesOptions } from '@lumx/core/stories/types';
-import { type ListItemSize } from './ListItem';
-/**
- * Setup ListItem stories for a specific framework (React or Vue).
- * Framework-specific components are injected via `components`.
- */
-export declare function setup({ component, render: ListItem, components: { List, ListItemAction, Button, IconButton, Text, FlexBox, Thumbnail }, decorators: { withWrapper, withCombinations }, }: SetupStoriesOptions<{
-    decorators: 'withWrapper' | 'withCombinations';
-    components: {
-        List: any;
-        ListItemAction: any;
-        Button: any;
-        IconButton: any;
-        Text: any;
-        FlexBox: any;
-        Thumbnail: any;
-    };
-}>): {
-    meta: {
-        args: Partial<import("./ListItem").ListItemProps>;
-        argTypes: {
-            size: {
-                control: {
-                    type: "select" | "inline-radio";
-                };
-                options: ListItemSize[];
-                mapping: Record<string, ListItemSize> | undefined;
-            };
-        };
-        render?: any;
-        component: any;
-    };
-    Default: {
-        args: {
-            children: string;
-        };
-        decorators: ((story: any, context: any) => any)[];
-    };
-    AllStates: {
-        args: {
-            children: string;
-        };
-        decorators: ((story: any, context: any) => any)[];
-    };
-    ActionArea: {
-        argTypes: {
-            onClick: {
-                action: boolean;
-            };
-        };
-        render({ onClick, size }: any): import("react").JSX.Element;
-    };
-};

package/js/components/List/ListItemTests.d.ts

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

package/js/components/List/ListSection.d.ts

@@ -1,45 +0,0 @@
-import type { CommonRef, HasClassName, JSXElement, LumxClassName } from '../../types';
-import { TextProps } from '../Text';
-/**
- * Defines the props of the component.
- */
-export interface ListSectionProps extends HasClassName {
-    /** Section label displayed as the group title. Accepts a plain string or custom JSX content. */
-    label?: string | JSXElement;
-    /** Section icon */
-    icon?: string;
-    /** List items (should be ListItem, ListDivider, etc.). */
-    children: JSXElement;
-    /** Items wrapper forwarded props */
-    itemsWrapperProps?: Record<string, any>;
-    /** ID for the label element (used for aria-labelledby). */
-    id: string;
-    /** ref to the root element */
-    ref?: CommonRef;
-    /** Text component to use for rendering the label */
-    Text: (props: TextProps & Record<string, any>) => any;
-}
-/**
- * Component display name.
- */
-export declare const COMPONENT_NAME = "ListSection";
-/**
- * Component default class name and class prefix.
- */
-export declare const CLASSNAME: LumxClassName<typeof COMPONENT_NAME>;
-/**
- * Component default props.
- */
-export declare const DEFAULT_PROPS: Partial<ListSectionProps>;
-/**
- * ListSection component.
- *
- * @param  props Component props.
- * @return JSX element.
- */
-export declare const ListSection: {
-    (props: ListSectionProps): import("react").JSX.Element;
-    displayName: string;
-    className: "lumx-list-section";
-    defaultProps: Partial<ListSectionProps>;
-};

package/js/components/List/ListSectionStories.d.ts

@@ -1,125 +0,0 @@
-import type { SetupStoriesOptions } from '@lumx/core/stories/types';
-/**
- * Setup ListSection stories for a specific framework (React or Vue).
- * Framework-specific components are injected via `components`.
- */
-export declare function setup({ component: ListSection, components: { List, ListItem, ListDivider, FlexBox }, decorators: { withWrapper }, }: SetupStoriesOptions<{
-    decorators: 'withWrapper';
-    components: {
-        List: any;
-        ListItem: any;
-        ListDivider: any;
-        FlexBox: any;
-    };
-}>): {
-    meta: {
-        component: any;
-        argTypes: {
-            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;
-                };
-            };
-            'list.itemPadding': {
-                control: {
-                    type: "select" | "inline-radio";
-                };
-                options: ("big" | "huge" | undefined)[];
-                mapping: Record<string, "big" | "huge" | undefined> | undefined;
-            };
-            'listItem.size': {
-                control: {
-                    type: "select" | "inline-radio";
-                };
-                options: ("big" | "tiny" | "regular" | undefined)[];
-                mapping: Record<string, "big" | "tiny" | "regular" | undefined> | undefined;
-            };
-        };
-    };
-    Default: {
-        args: {
-            label: string;
-        };
-        render({ "list.itemPadding": itemPadding, "listItem.size": itemSize, ...args }: any): import("react").JSX.Element;
-    };
-    AutoDividerEdgeCases: {
-        render({ "list.itemPadding": itemPadding, "listItem.size": itemSize }: any): import("react").JSX.Element;
-    };
-    LabelVariants: {
-        render({ "list.itemPadding": itemPadding, "listItem.size": itemSize }: any): import("react").JSX.Element;
-        decorators: ((story: any, context: any) => any)[];
-    };
-    ClickableItems: {
-        argTypes: {
-            onClick: {
-                action: boolean;
-            };
-        };
-        args: {
-            'list.itemPadding': "big";
-            'listItem.size': "tiny";
-        };
-        render({ onClick, "list.itemPadding": itemPadding, "listItem.size": itemSize }: any): import("react").JSX.Element;
-    };
-};

package/js/components/List/ListSectionTests.d.ts

@@ -1,13 +0,0 @@
-import { SetupOptions } from '../../../testing';
-/**
- * Mounts the component and returns common DOM elements / data needed in multiple tests further down.
- */
-export declare const setup: (propsOverride: any | undefined, { render, ...options }: SetupOptions<any>) => {
-    props: any;
-    listSection: HTMLElement;
-    title: HTMLElement | null;
-    items: HTMLElement | null;
-    wrapper: Partial<import("../../../testing").SetupResult>;
-};
-declare const _default: (renderOptions: SetupOptions<any>) => void;
-export default _default;

package/js/components/List/ListStories.d.ts

@@ -1,34 +0,0 @@
-import type { SetupStoriesOptions } from '@lumx/core/stories/types';
-/**
- * Setup List stories for a specific framework (React or Vue).
- * Framework-specific components are injected via `components`.
- */
-export declare function setup({ component: List, components: { ListItem }, decorators: { withCombinations }, }: SetupStoriesOptions<{
-    decorators: 'withCombinations';
-    components: {
-        ListItem: any;
-    };
-}>): {
-    meta: {
-        component: any;
-        render: (args: any) => import("react").JSX.Element;
-        argTypes: {
-            itemPadding: {
-                control: {
-                    type: "select" | "inline-radio";
-                };
-                options: ("big" | "huge" | undefined)[];
-                mapping: Record<string, "big" | "huge" | undefined> | undefined;
-            };
-        };
-    };
-    Default: {};
-    ItemPadding: {
-        argTypes: {
-            itemPadding: {
-                control: boolean;
-            };
-        };
-        decorators: ((story: any, context: any) => any)[];
-    };
-};

package/js/components/List/ListTests.d.ts

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

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

@@ -1,39 +0,0 @@
-import { Size } from '../../constants';
-import type { CommonRef, HasClassName, JSXElement, LumxClassName } from '../../types';
-/** List item padding size. */
-export type ListItemPadding = Extract<Size, 'big' | 'huge'>;
-/**
- * Defines the props of the component.
- */
-export interface ListProps extends HasClassName {
-    /** List content (should be ListItem, ListDivider, etc.). */
-    children?: JSXElement;
-    /** Item padding size. */
-    itemPadding?: ListItemPadding;
-    /** ref to the root element */
-    ref?: CommonRef;
-}
-/**
- * Component display name.
- */
-export declare const COMPONENT_NAME = "List";
-/**
- * Component default class name and class prefix.
- */
-export declare const CLASSNAME: LumxClassName<typeof COMPONENT_NAME>;
-/**
- * Component default props.
- */
-export declare const DEFAULT_PROPS: Partial<ListProps>;
-/**
- * List component.
- *
- * @param  props Component props.
- * @return JSX element.
- */
-export declare const List: {
-    (props: ListProps): import("react").JSX.Element;
-    displayName: string;
-    className: "lumx-list";
-    defaultProps: Partial<ListProps>;
-};

package/js/components/Menu/MenuButton.d.ts

@@ -1,41 +0,0 @@
-import type { JSXElement, LumxClassName } from '../../types';
-export type MenuButtonVariant = 'button' | 'icon-button' | 'chip' | 'link';
-export declare const DEFAULT_PROPS: {
-    variant: "button";
-};
-/** ARIA keys set by MenuButton on the trigger — omitted from variant component props. */
-type MenuButtonAriaKeys = 'aria-haspopup' | 'aria-controls' | 'aria-expanded';
-/** Per-variant keys internally managed by MenuButton — omitted from variant component props. */
-type MenuButtonVariantsInternalKeys = {
-    button: MenuButtonAriaKeys;
-    'icon-button': MenuButtonAriaKeys;
-    chip: MenuButtonAriaKeys | 'isClickable';
-    link: MenuButtonAriaKeys | 'href' | 'linkAs';
-};
-/** Discriminated union of MenuButton props across all trigger variants. */
-export type MenuButtonVariantsProps<TBase, TVariantProps extends Record<MenuButtonVariant, any>> = {
-    [V in MenuButtonVariant]: TBase & (V extends 'button' ? {
-        variant?: V;
-    } : {
-        variant: V;
-    }) & Omit<TVariantProps[V], MenuButtonVariantsInternalKeys[V] | keyof TBase>;
-}[MenuButtonVariant];
-export interface MenuButtonProps {
-    variant?: MenuButtonVariant;
-    label?: JSXElement;
-    children?: JSXElement;
-    triggerProps?: Record<string, any>;
-    popoverProps?: Record<string, any>;
-    onOpen?: (isOpen: boolean) => void;
-}
-export interface MenuButtonComponents {
-    MenuProvider: any;
-    MenuTrigger: any;
-    MenuPopover: any;
-    MenuList: any;
-}
-export declare const COMPONENT_NAME = "MenuButton";
-export declare const CLASSNAME: LumxClassName<typeof COMPONENT_NAME>;
-/** Menu button core template (composition of menu provider, trigger, popover and list) */
-export declare const MenuButton: (props: MenuButtonProps, { MenuProvider, MenuTrigger, MenuPopover, MenuList }: MenuButtonComponents) => import("react").JSX.Element;
-export {};

package/js/components/Menu/MenuButtonStories.d.ts

@@ -1,50 +0,0 @@
-import type { SetupStoriesOptions } from '@lumx/core/stories/types';
-export declare function setup({ components: { MenuButton, MenuItem, MenuDivider }, decorators: { withCombinations }, }: SetupStoriesOptions<{
-    components: {
-        MenuButton: any;
-        MenuItem: any;
-        MenuDivider: any;
-    };
-    decorators: 'withCombinations';
-}>): {
-    meta: {
-        component: any;
-        argTypes: {
-            onOpen: {
-                action: boolean;
-            };
-        };
-        args: {
-            label: string;
-        };
-        play(): Promise<void>;
-    };
-    Default: {
-        argTypes: {
-            onItemClick: {
-                action: boolean;
-            };
-        };
-        render: ({ onItemClick, ...args }: any) => import("react").JSX.Element;
-    };
-    Variants: {
-        argTypes: {
-            onItemClick: {
-                action: boolean;
-            };
-        };
-        decorators: ((story: any, context: any) => any)[];
-        render: ({ onItemClick, ...args }: any) => import("react").JSX.Element;
-    };
-    WithLinkItems: {
-        argTypes: {
-            onItemClick: {
-                action: boolean;
-            };
-        };
-        args: {
-            label: string;
-            emphasis: string;
-        };
-    };
-};

package/js/components/Menu/MenuButtonTestStories.d.ts

@@ -1,31 +0,0 @@
-export declare function setup({ components: { MenuButton, MenuItem } }: {
-    components: {
-        MenuButton: any;
-        MenuItem: any;
-    };
-}): {
-    meta: {
-        tags: string[];
-        args: {
-            onOne: import("storybook/test").Mock<(...args: any[]) => any>;
-            onTwo: import("storybook/test").Mock<(...args: any[]) => any>;
-            onThree: import("storybook/test").Mock<(...args: any[]) => any>;
-        };
-        render: (args: any) => import("react").JSX.Element;
-    };
-    TabFromLastItemClosesAndMovesFocus: {
-        play: ({ canvasElement }: any) => Promise<void>;
-    };
-    ShiftTabFromFirstItemClosesAndReturnsToTrigger: {
-        play: ({ canvasElement }: any) => Promise<void>;
-    };
-    EscapeRestoresFocusToTrigger: {
-        play: ({ canvasElement }: any) => Promise<void>;
-    };
-    ItemActivationRestoresFocusToTrigger: {
-        play: ({ canvasElement, args }: any) => Promise<void>;
-    };
-    ClickAwayClosesMenu: {
-        play: ({ canvasElement }: any) => Promise<void>;
-    };
-};

package/js/components/Menu/MenuButtonTests.d.ts

@@ -1,34 +0,0 @@
-type RenderResult = {
-    unmount: () => void;
-    container: Element;
-};
-/**
- * Options to set up the MenuButton test suite.
- * Injected by the framework-specific test file (React or Vue).
- */
-export interface MenuButtonTestSetup {
-    components: {
-        MenuButton: any;
-        MenuItem: any;
-    };
-    /**
-     * Render a MenuButton template, forwarding optional framework-specific render options
-     * (e.g. `{ wrapper }` in React, `{ global }` in Vue).
-     *
-     * @param template JSX render function returning the element to render.
-     * @param options  Framework-specific render options (e.g. wrapper component).
-     */
-    render: (template: () => any, options?: Record<string, any>) => RenderResult;
-}
-export default function menuButtonTests({ components, render }: MenuButtonTestSetup): {
-    setup: (propsOverride?: Record<string, any>, options?: Record<string, any>) => {
-        props: {
-            label: string;
-        };
-        container: Element;
-        element: HTMLElement;
-        trigger: HTMLElement;
-    };
-    triggerClassName: "lumx-menu-trigger";
-};
-export {};

package/js/components/Menu/MenuItem.d.ts

@@ -1,26 +0,0 @@
-import type { CommonRef, HasClassName, JSXElement, LumxClassName } from '../../types';
-/** MenuItem props. */
-export interface MenuItemProps extends HasClassName {
-    /** Item label content. */
-    children?: JSXElement;
-    /** Content rendered before the label (e.g. an icon). */
-    before?: JSXElement;
-    /** Content rendered after the label (e.g. a shortcut hint). */
-    after?: JSXElement;
-    /** Whether the item is disabled. Skipped by Tab and arrow nav. */
-    isDisabled?: boolean;
-    /** Click handler for the action element. */
-    handleClick?(event: any): void;
-    /** Extra props forwarded to the inner action element (e.g. link props when `as="a"`). */
-    actionProps?: Record<string, any>;
-    /** ref to the inner action element (the focusable `<button>` / `<a>`). */
-    actionRef?: CommonRef;
-    /** ref to the root `<li>` element. */
-    ref?: CommonRef;
-}
-/** Props overridden by framework wrappers. */
-export type MenuItemPropsToOverride = 'before' | 'after' | 'children' | 'handleClick' | 'actionProps' | 'actionRef';
-export declare const COMPONENT_NAME = "MenuItem";
-export declare const CLASSNAME: LumxClassName<typeof COMPONENT_NAME>;
-/** MenuItem core template. Renders a `ListItem` with a `ListItemAction`. */
-export declare const MenuItem: (props: MenuItemProps) => import("react").JSX.Element;

package/js/components/Menu/MenuItemTests.d.ts

@@ -1,11 +0,0 @@
-import { SetupOptions } from '../../../testing';
-/**
- * Mounts the component and returns common DOM elements / data needed in multiple tests further down.
- */
-export declare const setup: (propsOverride: any | undefined, { render, screen, ...options }: SetupOptions<any>) => {
-    props: any;
-    menuItem: HTMLElement;
-    action: HTMLElement;
-    screen: import("@testing-library/dom").Screen;
-};
-export declare function menuItemTests(renderOptions: SetupOptions<any>): void;

package/js/components/Menu/MenuList.d.ts

@@ -1,16 +0,0 @@
-import type { CommonRef, HasClassName, JSXElement, LumxClassName } from '../../types';
-/** Menu list props. */
-export type MenuListProps = HasClassName & {
-    /** Menu content (MenuItem, ListDivider, ListSection…). */
-    children?: JSXElement;
-    /** The id of the menu container element (matches `aria-controls` on the trigger). */
-    id?: string;
-    /** The id of the element that labels the menu (auto-set to the trigger id by wrappers). */
-    'aria-labelledby'?: string;
-    /** ref to the root `<ul>` element. */
-    ref?: CommonRef;
-};
-export declare const COMPONENT_NAME = "Menu";
-export declare const CLASSNAME: LumxClassName<typeof COMPONENT_NAME>;
-/** MenuList core template. Wraps `List` with menu-specific class and ARIA labelling. */
-export declare const MenuList: (props: MenuListProps) => import("react").JSX.Element;

package/js/components/Menu/MenuPopover.d.ts

@@ -1,18 +0,0 @@
-import type { HasClassName, JSXElement, LumxClassName } from '../../types';
-import { PopoverProps } from '../Popover';
-/** MenuPopover props. */
-export interface MenuPopoverProps extends HasClassName, Pick<PopoverProps, 'placement' | 'anchorRef' | 'isOpen' | 'handleClose'> {
-    /** Popover content (a `Menu`). */
-    children?: JSXElement;
-}
-/** Framework components injected by wrappers. */
-export interface MenuPopoverComponents {
-    /** Popover component (framework-specific). */
-    Popover: any;
-    /** FlexBox component (framework-specific). */
-    FlexBox: any;
-}
-export declare const COMPONENT_NAME = "MenuPopover";
-export declare const CLASSNAME: LumxClassName<typeof COMPONENT_NAME>;
-/** MenuPopover core template. Renders a `Popover` with menu-friendly defaults. */
-export declare const MenuPopover: (props: MenuPopoverProps, { Popover, FlexBox }: MenuPopoverComponents) => import("react").JSX.Element;

package/js/components/Menu/MenuTrigger.d.ts

@@ -1,23 +0,0 @@
-import type { CommonRef, HasClassName, JSXElement, LumxClassName } from '../../types';
-/** MenuTrigger props. */
-export interface MenuTriggerProps extends HasClassName {
-    /** Content of the trigger (label / icon / etc.). */
-    children?: JSXElement;
-    /** The id of the trigger element. */
-    id?: string;
-    /** The id of the menu container (for `aria-controls`). */
-    menuId?: string;
-    /** Whether the menu is currently open. */
-    isOpen?: boolean;
-    /** ref to the trigger element. */
-    ref?: CommonRef;
-}
-/** Framework components injected by wrappers. */
-export interface MenuTriggerComponents {
-    /** Component to render as the trigger (e.g. Button, IconButton, Chip, link). */
-    Trigger: any;
-}
-export declare const COMPONENT_NAME = "MenuTrigger";
-export declare const CLASSNAME: LumxClassName<typeof COMPONENT_NAME>;
-/** MenuTrigger core template. Renders `Trigger` with disclosure ARIA attributes. */
-export declare const MenuTrigger: (props: MenuTriggerProps, { Trigger }: MenuTriggerComponents) => import("react").JSX.Element;

package/js/components/Menu/setupMenu.d.ts

@@ -1,18 +0,0 @@
-import type { MenuHandle, SetupMenuOptions } from './types';
-/**
- * Set up a disclosure-pattern menu handle.
- *
- * The trigger is registered separately via {@link MenuHandle.registerTrigger}
- * once the trigger mounts. The menu container is registered separately via
- * {@link MenuHandle.registerMenu} once on mount — the popover uses
- * `closeMode="hide"` so the `<ul>` stays in the DOM at all times.
- *
- * IMPORTANT: this is the **disclosure widget** pattern, NOT WAI-ARIA's
- * `role="menu"`. Items are native `<button>` / `<a>` elements with `tabindex="0"`,
- * so screen readers announce them naturally and Tab navigates between them in
- * DOM order. There is no focus trap.
- *
- * @param options Options (menuId for `aria-controls`).
- * @returns A {@link MenuHandle} for interacting with the menu.
- */
-export declare function setupMenu(options?: SetupMenuOptions): MenuHandle;