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

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

@@ -1,89 +0,0 @@
-import type { SetupStoriesOptions } from '@lumx/core/stories/types';
-/**
- * Setup Checkbox 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: Checkbox, decorators: { withCombinations, withValueOnChange }, }: SetupStoriesOptions<{
-    decorators: 'withCombinations' | 'withValueOnChange';
-}>): {
-    meta: {
-        component: any;
-        render: (args: any) => import("react").JSX.Element;
-        decorators: ((story: any, context: any) => 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;
-            handleChange?: ((isChecked: boolean, 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 checkbox */
-    Default: {};
-    /** With label and helper */
-    LabelAndHelper: {
-        argTypes: {
-            label: {
-                control: string;
-            };
-            helper: {
-                control: string;
-            };
-        };
-        args: {
-            label: string;
-            helper: string;
-        };
-    };
-    /** With intermediate state */
-    IntermediateState: {
-        argTypes: {
-            isChecked: {
-                control: boolean;
-            };
-        };
-        args: {
-            isChecked: string;
-        };
-    };
-    /** Disabled */
-    Disabled: {
-        argTypes: {
-            isDisabled: {
-                control: boolean;
-            };
-            'aria-disabled': {
-                control: boolean;
-            };
-        };
-        args: {
-            label: string;
-            helper: string;
-        };
-        decorators: ((story: any, context: any) => any)[];
-    };
-};

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

@@ -1,15 +0,0 @@
-import { SetupOptions } from '../../../testing';
-import { CheckboxProps } from '.';
-type SetupProps = Partial<CheckboxProps>;
-/**
- * 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<CheckboxProps>) => {
-    checkbox: HTMLElement;
-    helper: HTMLElement | null;
-    label: HTMLElement | null;
-    input: HTMLElement;
-    props: CheckboxProps;
-};
-declare const _default: (renderOptions: SetupOptions<CheckboxProps>) => void;
-export default _default;

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

@@ -1,49 +0,0 @@
-import type { JSXElement, LumxClassName, HasTheme, HasAriaDisabled, HasDisabled, HasClassName, HasChecked, CommonRef } from '../../types';
-/**
- * Intermediate state of checkbox.
- */
-export declare const INTERMEDIATE_STATE = "intermediate";
-/**
- * Defines the props of the component.
- */
-export interface CheckboxProps extends HasTheme, HasClassName, HasAriaDisabled, HasDisabled, HasChecked<boolean | 'intermediate'> {
-    /** Helper text. */
-    helper?: string;
-    /** Native input id property. */
-    id?: string;
-    /** Label text. */
-    label?: JSXElement;
-    /** Native input name property. */
-    name?: string;
-    /** Native input value property. */
-    value?: string;
-    /** optional props for input */
-    inputProps?: Record<string, any>;
-    /** Native input ref. */
-    inputRef?: CommonRef;
-    /** Native input id. */
-    inputId: string;
-    /** On change callback. */
-    handleChange?(isChecked: boolean, value?: string, name?: string, event?: any): void;
-    /** reference to the root element */
-    ref?: CommonRef;
-}
-/**
- * Component display name.
- */
-export declare const COMPONENT_NAME = "Checkbox";
-/**
- * Component default class name and class prefix.
- */
-export declare const CLASSNAME: LumxClassName<typeof COMPONENT_NAME>;
-/**
- * Component default props.
- */
-export declare const DEFAULT_PROPS: Partial<CheckboxProps>;
-/**
- * Checkbox component.
- *
- * @param  props Component props.
- * @return JSX element.
- */
-export declare const Checkbox: (props: CheckboxProps) => import("react").JSX.Element;

package/js/components/Chip/ChipGroup.d.ts

@@ -1,35 +0,0 @@
-import { HorizontalAlignment } from '../../constants';
-import type { JSXElement, LumxClassName, HasClassName, CommonRef } from '../../types';
-/**
- * Defines the props of the component.
- */
-export interface ChipGroupProps extends HasClassName {
-    /**
-     * Chip horizontal alignment.
-     * @deprecated
-     */
-    align?: HorizontalAlignment;
-    /** Children */
-    children?: JSXElement;
-    /** reference to the root element */
-    ref?: CommonRef;
-}
-/**
- * Component display name.
- */
-export declare const COMPONENT_NAME = "ChipGroup";
-/**
- * Component default class name and class prefix.
- */
-export declare const CLASSNAME: LumxClassName<typeof COMPONENT_NAME>;
-/**
- * Component default props.
- */
-export declare const DEFAULT_PROPS: Partial<ChipGroupProps>;
-/**
- * ChipGroup component.
- *
- * @param  props Component props.
- * @return JSX element.
- */
-export declare const ChipGroup: (props: ChipGroupProps) => import("react").JSX.Element;

package/js/components/Chip/ChipGroupStories.d.ts

@@ -1,17 +0,0 @@
-import type { SetupStoriesOptions } from '@lumx/core/stories/types';
-export declare function setup({ component: ChipGroup, components: { Chip }, }: SetupStoriesOptions<{
-    components: {
-        Chip: any;
-    };
-}>): {
-    meta: {
-        component: any;
-        args: Partial<import("./ChipGroup").ChipGroupProps>;
-    };
-    Default: {
-        render: () => import("react").JSX.Element;
-    };
-    Small: {
-        render: () => import("react").JSX.Element;
-    };
-};

package/js/components/Chip/ChipGroupTests.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;
-    chipGroup: HTMLElement;
-    wrapper: Partial<import("../../../testing").SetupResult>;
-};
-declare const _default: (renderOptions: SetupOptions<any>) => void;
-export default _default;

package/js/components/Chip/SelectionChipGroup.d.ts

@@ -1,56 +0,0 @@
-import type { LumxClassName, HasClassName, HasTheme } from '../../types';
-import type { Selector } from '../../types/Selector';
-import type { ChipProps } from '.';
-/**
- * Framework-specific components injected by React/Vue wrappers.
- */
-export interface SelectionChipGroupComponents {
-    Chip: any;
-    ChipGroup: any;
-    Icon: any;
-    Text: any;
-    Tooltip: any;
-}
-/**
- * Props that consumers can override per chip via getChipProps.
- * Excludes internal/framework props that the core always controls.
- */
-export type ChipOverrideProps = Pick<ChipProps, 'isDisabled' | 'color' | 'isHighlighted' | 'isSelected' | 'className' | 'before' | 'after'>;
-/**
- * Defines the props of the component.
- */
-export interface SelectionChipGroupProps<O> extends HasClassName, HasTheme {
-    /** Option object id selector (either a property name or a function to get the id) */
-    getOptionId: Selector<O>;
-    /** Option object name selector. Falls back to the id if not defined */
-    getOptionName?: Selector<O, string | undefined | null>;
-    /** Selected options array */
-    value?: O[];
-    /** Label for accessibility (aria-label on the listbox) */
-    label: string;
-    /** Label for the remove action (visually hidden text appended to each chip) */
-    chipRemoveLabel?: string;
-    /** Disabled state for all chips */
-    isDisabled?: boolean;
-    /** Customize chip props per option */
-    getChipProps?: (option: O) => Partial<ChipProps>;
-    /** Ref for the container element */
-    ref?: any;
-}
-/**
- * Component display name.
- */
-export declare const COMPONENT_NAME = "SelectionChipGroup";
-/**
- * Component default class name and class prefix.
- */
-export declare const CLASSNAME: LumxClassName<typeof COMPONENT_NAME>;
-/**
- * SelectionChipGroup component.
- * Renders a listbox of removable selection chips using component injection for framework-agnostic rendering.
- *
- * @param props      Component props.
- * @param components Framework-specific components injected by the wrapper (Chip, ChipGroup, Icon, Tooltip).
- * @return JSX element, or null when value is empty.
- */
-export declare const SelectionChipGroup: <O>(props: SelectionChipGroupProps<O>, { Chip, ChipGroup, Icon, Text, Tooltip }: SelectionChipGroupComponents) => import("react").JSX.Element | null;

package/js/components/Chip/SelectionChipGroupStories.d.ts

@@ -1,54 +0,0 @@
-import type { SetupStoriesOptions } from '@lumx/core/stories/types';
-declare const fruits: {
-    id: string;
-    name: string;
-}[];
-type FruitOption = (typeof fruits)[number];
-export declare function setup({ component: SelectionChipGroup, decorators: { withValueOnChange, withResizableBox }, }: SetupStoriesOptions<{
-    decorators: 'withValueOnChange' | 'withResizableBox';
-}>): {
-    meta: {
-        component: any;
-        args: {
-            value: {
-                id: string;
-                name: string;
-            }[];
-            getOptionId: string;
-            getOptionName: string;
-            label: string;
-            chipRemoveLabel: string;
-        };
-        decorators: ((story: any, context: any) => any)[];
-    };
-    Default: {};
-    Disabled: {
-        args: {
-            isDisabled: boolean;
-        };
-    };
-    IndividuallyDisabled: {
-        args: {
-            getChipProps: (option: FruitOption) => {
-                isDisabled: boolean;
-            };
-        };
-    };
-    Empty: {
-        args: {
-            value: never[];
-        };
-    };
-    ConstrainedSpace: {
-        decorators: ((story: any, context: any) => any)[];
-        args: {
-            value: ({
-                id: string;
-                name: string;
-            } | {
-                name: string;
-            })[];
-        };
-    };
-};
-export {};

package/js/components/Chip/SelectionChipGroupTests.d.ts

@@ -1,23 +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;
-    selectionChipGroup: HTMLElement | null;
-    wrapper: Partial<import("../../../testing").SetupResult>;
-};
-interface CoreTestOptions extends SetupOptions<any> {
-    /**
-     * Render a stateful SelectionChipGroup that updates its own value on change.
-     * Should also render a sibling `<input>` element wired via `inputRef` so the
-     * keyboard navigation tests can assert focus fallback to the input.
-     *
-     * When provided, enables roving tabindex recovery and keyboard navigation tests.
-     *
-     * @param initialValue Optional initial value (defaults to all 3 testOptions).
-     */
-    renderStateful?: (initialValue?: any[]) => void;
-}
-declare const _default: (renderOptions: CoreTestOptions) => void;
-export default _default;

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

@@ -1,127 +0,0 @@
-import type { SetupStoriesOptions } from '@lumx/core/stories/types';
-export declare function setup({ component: Chip, components: { Icon }, decorators: { withCombinations, withThemedBackground, withTheming }, }: SetupStoriesOptions<{
-    decorators: 'withCombinations' | 'withThemedBackground' | 'withTheming';
-    components: {
-        Icon: any;
-    };
-}>): {
-    meta: {
-        component: any;
-        render: ({ children, ...args }: any) => import("react").JSX.Element;
-        args: import("lodash").Omit<Partial<import(".").ChipProps>, "theme">;
-        argTypes: {
-            size: {
-                control: {
-                    type: "select" | "inline-radio";
-                };
-                options: ("s" | "m")[];
-                mapping: Record<string, "s" | "m"> | undefined;
-            };
-            before: {
-                control: boolean;
-            };
-            after: {
-                control: boolean;
-            };
-        };
-    };
-    Default: {
-        args: {
-            children: string;
-        };
-    };
-    ChipButton: {
-        args: {
-            children: string;
-        };
-        argTypes: {
-            onClick: {
-                action: boolean;
-            };
-        };
-    };
-    ChipLink: {
-        args: {
-            children: string;
-            href: string;
-            target: string;
-        };
-    };
-    WithAfterAndBefore: {
-        argTypes: {
-            onBeforeClick: {
-                action: boolean;
-            };
-            onClick: {
-                action: boolean;
-            };
-            onAfterClick: {
-                action: boolean;
-            };
-        };
-        render: ({ children, ...args }: any) => import("react").JSX.Element;
-        args: {
-            children: string;
-        };
-    };
-    ColorVariants: {
-        render: ({ children, ...args }: any) => import("react").JSX.Element;
-        argTypes: {
-            onBeforeClick: {
-                action: boolean;
-            };
-            onClick: {
-                action: boolean;
-            };
-            onAfterClick: {
-                action: boolean;
-            };
-        };
-        args: {
-            children: string;
-        };
-        decorators: ((story: any, context: any) => any)[];
-    };
-    SelectedVariants: {
-        render: ({ children, ...args }: any) => import("react").JSX.Element;
-        argTypes: {
-            onBeforeClick: {
-                action: boolean;
-            };
-            onClick: {
-                action: boolean;
-            };
-            onAfterClick: {
-                action: boolean;
-            };
-        };
-        args: {
-            children: string;
-        };
-        decorators: ((story: any, context: any) => any)[];
-    };
-    Disabled: {
-        args: {
-            children: string;
-        };
-        decorators: ((story: any, context: any) => any)[];
-    };
-    Theming: {
-        decorators: ((story: any, context: any) => any)[];
-        render: ({ children, ...args }: any) => import("react").JSX.Element;
-        argTypes: {
-            onBeforeClick: {
-                action: boolean;
-            };
-            onClick: {
-                action: boolean;
-            };
-            onAfterClick: {
-                action: boolean;
-            };
-        };
-        args: {
-            children: string;
-        };
-    };
-};

package/js/components/Chip/Tests.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;
-    chip: HTMLElement;
-    wrapper: Partial<import("../../../testing").SetupResult>;
-};
-declare const _default: (renderOptions: SetupOptions<any>) => void;
-export default _default;

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

@@ -1,81 +0,0 @@
-import { ColorPalette, Size } from '../../constants';
-import { HasTheme, HasAriaDisabled, JSXElement, LumxClassName, HasClassName, HasDisabled, CommonRef, GenericProps } from '../../types';
-/**
- * Chip sizes.
- */
-export type ChipSize = Extract<Size, 's' | 'm'>;
-/**
- * Defines the props of the component.
- */
-export interface ChipProps extends HasClassName, HasDisabled, HasTheme, HasAriaDisabled {
-    /** A component to be rendered after the content. */
-    after?: JSXElement;
-    /** A component to be rendered before the content. */
-    before?: JSXElement;
-    /** Color variant. */
-    color?: ColorPalette;
-    /** Whether the component is clickable or not. */
-    isClickable?: boolean;
-    /** Whether the chip is currently in a highlighted state or not. */
-    isHighlighted?: boolean;
-    /** Whether the component is selected or not. */
-    isSelected?: boolean;
-    /** Size variant. */
-    size?: ChipSize;
-    /** href for the chip if it is a link */
-    href?: string;
-    /** reference to the root element */
-    ref?: CommonRef;
-    /** On "after" element clicked callback. */
-    handleAfterClick?: (event: any) => void;
-    /** On element key down callback. */
-    handleKeyDown?: (event: any) => void;
-    /** On "before" element clicked callback. */
-    handleBeforeClick?: (event: any) => void;
-    /** On element clicked callback. */
-    handleClick?: (event: any) => void;
-    /** name of the prop for handling key down events */
-    keyDownProp?: string;
-    /** name of the prop for tab index */
-    tabIndexProp?: string;
-    /** Children */
-    children?: JSXElement;
-    /** Props to apply when the component is in a disabled state. */
-    disabledStateProps: GenericProps;
-    /** Whether the "after" element has a click handler. */
-    hasAfterClick?: boolean;
-    /** Whether the "before" element has a click handler. */
-    hasBeforeClick?: boolean;
-    /** Whether the component has a main click handler. */
-    hasOnClick?: boolean;
-    /** Whether any part of the component is disabled. */
-    isAnyDisabled?: boolean;
-}
-export type ChipPropsToOverride = 'disabledStateProps' | 'hasOnClick' | 'hasBeforeClick' | 'hasAfterClick' | 'before' | 'after' | 'keyDownProp' | 'tabIndexProp' | 'isAnyDisabled';
-/**
- * Component display name.
- */
-export declare const COMPONENT_NAME = "Chip";
-/**
- * Component default class name and class prefix.
- */
-export declare const CLASSNAME: LumxClassName<typeof COMPONENT_NAME>;
-export declare const block: {
-    (additionalClasses: import("../../utils/classNames/bem/types").AdditionalClasses): string;
-    (modifiers?: import("../../utils/classNames/bem/types").Modifier, additionalClasses?: import("../../utils/classNames/bem/types").AdditionalClasses): string;
-}, element: {
-    (elem: string, additionalClasses: import("../../utils/classNames/bem/types").AdditionalClasses): string;
-    (elem: string, modifiers?: import("../../utils/classNames/bem/types").Modifier, additionalClasses?: import("../../utils/classNames/bem/types").AdditionalClasses): string;
-};
-/**
- * Component default props.
- */
-export declare const DEFAULT_PROPS: Partial<ChipProps>;
-/**
- * Chip component.
- *
- * @param  props Component props.
- * @param  ref   Component ref.
- * @return React element.
- */
-export declare const Chip: (props: ChipProps) => import("react").JSX.Element;

package/js/components/Chip/setupSelectionChipGroupEvents.d.ts

@@ -1,28 +0,0 @@
-import type { Selector } from '../../types/Selector';
-/**
- * Options for setting up selection chip group event handlers.
- * All option accessors are wrapped in getters so that React/Vue can provide
- * reactive values without the core needing to know about reactivity systems.
- */
-export interface SetupSelectionChipGroupEventsOptions<O> {
-    /** Getter for the current selected options array. */
-    getValue: () => O[] | undefined;
-    /** Getter for the option id selector. */
-    getOptionId: Selector<O>;
-    /** Callback when the option array changes. */
-    onChange: (newValue?: O[]) => void;
-    /** Getter for the chip group container element. */
-    getContainer: () => HTMLElement | null | undefined;
-    /** Getter for the associated input element (optional). */
-    getInput?: () => HTMLInputElement | null | undefined;
-}
-/**
- * Attach delegated click and keydown event listeners on the chip group container,
- * and optionally an input backspace handler.
- *
- * Uses addEventListener on the container element. Events bubble up from individual
- * chips, so there is no need to re-attach listeners when chips change.
- *
- * @returns A cleanup function that removes all attached event listeners.
- */
-export declare function setupSelectionChipGroupEvents<O>(options: SetupSelectionChipGroupEventsOptions<O>): () => void;

package/js/components/Combobox/ComboboxButton.d.ts

@@ -1,57 +0,0 @@
-import type { CommonRef, HasClassName, JSXElement, LumxClassName } from '../../types';
-import type { ComboboxCallbacks } from './types';
-/**
- * Label display mode for the ComboboxButton.
- * - `'show-selection'`: Show the selected value if available, otherwise the label.
- * - `'show-label'`: Always show the label.
- * - `'show-tooltip'`: Show nothing in the button; label appears only in tooltip.
- */
-export type ComboboxButtonLabelDisplayMode = 'show-selection' | 'show-label' | 'show-tooltip';
-/**
- * Defines the props for the core ComboboxButton template.
- */
-export interface ComboboxButtonProps extends HasClassName, ComboboxCallbacks {
-    /** The label for the button (used for ARIA and tooltip). */
-    label: string;
-    /** The currently selected value to display. */
-    value?: string;
-    /** Controls how the label/value is displayed. */
-    labelDisplayMode?: ComboboxButtonLabelDisplayMode;
-    /** The ID of the listbox element (for aria-controls). */
-    listboxId?: string;
-    /** Whether the combobox is open. */
-    isOpen?: boolean;
-    /** ref to the root button element. */
-    ref?: CommonRef;
-    /** Custom render button */
-    renderButton?: (buttonProps: Record<string, any>) => JSXElement;
-}
-/**
- * Injected framework-specific components for ComboboxButton rendering.
- */
-export interface ComboboxButtonComponents {
-    /** Button component (framework-specific, e.g. React Button with theme/disabled handling). */
-    Button: any;
-    /** Tooltip wrapper component. */
-    Tooltip: any;
-}
-/**
- * Component display name.
- */
-export declare const COMPONENT_NAME = "ComboboxButton";
-/**
- * Component default class name and class prefix.
- */
-export declare const CLASSNAME: LumxClassName<typeof COMPONENT_NAME>;
-/**
- * ComboboxButton core template.
- * Renders a Button with combobox ARIA attributes, wrapped in a Tooltip.
- *
- * Framework-specific components (Tooltip) are passed as a second argument
- * by the React/Vue wrappers.
- *
- * @param props      Component props.
- * @param components Injected framework-specific components.
- * @return JSX element.
- */
-export declare const ComboboxButton: (props: ComboboxButtonProps, { Button, Tooltip }: ComboboxButtonComponents) => import("react").JSX.Element;