@lumx/core 4.9.0-alpha.1 → 4.9.0-alpha.3

package/components-and-utils.css

@@ -8233,7 +8233,7 @@ table {
 
 /* Section
    ========================================================================== */
-.lumx-list-section:not(:first-child):not(.lumx-list-section:not([hidden]) + .lumx-list-section):not(.lumx-list-divider + .lumx-list-section)::before {
+.lumx-list-section:not([hidden]) ~ .lumx-list-section:not(.lumx-list-section:not([hidden]) + .lumx-list-section):not(.lumx-list-divider + .lumx-list-section)::before {
   content: "";
   display: block;
   height: 1px;

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

@@ -1,8 +1,8 @@
-import type { CommonRef, HasClassName, LumxClassName } from '../../types';
+import type { CommonRef, HasClassName, HasTheme, LumxClassName } from '../../types';
 /**
  * Defines the props for the core ComboboxInput template.
  */
-export interface ComboboxInputProps extends HasClassName {
+export interface ComboboxInputProps extends HasClassName, HasTheme {
     /** The ID of the listbox element (for aria-controls). */
     listboxId?: string;
     /** Whether the combobox is open. */

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

@@ -41,6 +41,8 @@ export interface ComboboxOptionProps extends HasClassName {
     hidden?: boolean;
     /** On click callback. */
     handleClick?(): void;
+    /** Extra props forwarded to the inner action element (e.g. link props when as="a"). */
+    actionProps?: Record<string, any>;
     /** ref to the root <li> element. */
     ref?: CommonRef;
     /** The value for this option (used for selection). */
@@ -50,7 +52,7 @@ export interface ComboboxOptionProps extends HasClassName {
  * Props that React/Vue wrappers need to re-declare with framework-specific types.
  * Used by `ReactToJSX<ComboboxOptionProps, ComboboxOptionPropsToOverride>`.
  */
-export type ComboboxOptionPropsToOverride = 'before' | 'after' | 'children' | 'tooltipProps';
+export type ComboboxOptionPropsToOverride = 'before' | 'after' | 'children' | 'tooltipProps' | 'actionProps';
 /**
  * Component display name.
  */

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

@@ -15,6 +15,8 @@ export interface ComboboxOptionMoreInfoProps extends HasClassName {
     onMouseEnter?(): void;
     /** Mouse leave callback. */
     onMouseLeave?(): void;
+    /** Props forwarded to the IconButton. */
+    buttonProps?: Record<string, any>;
 }
 /**
  * Props that React/Vue wrappers need to re-declare with framework-specific types.

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

@@ -13,6 +13,12 @@ export interface ComboboxOptionSkeletonProps extends HasClassName {
     children?: JSXElement;
     /** ref to the root <li> element. */
     ref?: CommonRef;
+    /**
+     * Number of skeleton `<li>` elements to render.
+     * Each is an independent element with `:nth-child` width cycling applied by SCSS.
+     * @default 1
+     */
+    count?: number;
 }
 /**
  * Props that React/Vue wrappers need to re-declare with framework-specific types.

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

@@ -3,8 +3,8 @@ import type { CommonRef, HasClassName, JSXElement, LumxClassName } from '../../t
  * Defines the props for the core ComboboxSection template.
  */
 export interface ComboboxSectionProps extends HasClassName {
-    /** Section label displayed as the group title. */
-    label?: string;
+    /** Section label displayed as the group title. Accepts a plain string or custom JSX content. */
+    label?: string | JSXElement;
     /** Section icon */
     icon?: string;
     /** Section content (should be ComboboxOption elements). */

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

@@ -53,6 +53,12 @@ export interface ComboboxStateProps {
          * Used to suppress false "empty" state while data is loading.
          */
         isLoading?: boolean;
+        /**
+         * Whether the combobox popover is open.
+         * Used to gate live region content so screen readers announce messages
+         * when the popover opens (content insertion triggers `aria-live` announcement).
+         */
+        isOpen?: boolean;
     };
 }
 /**

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

@@ -21,3 +21,5 @@ export { ComboboxSection } from './ComboboxSection';
 export type { ComboboxSectionProps, ComboboxSectionPropsToOverride, ComboboxSectionComponents, } from './ComboboxSection';
 export { ComboboxState } from './ComboboxState';
 export type { ComboboxStateProps } from './ComboboxState';
+export { subscribeComboboxState } from './subscribeComboboxState';
+export type { ComboboxStateSetters } from './subscribeComboboxState';

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

@@ -13,7 +13,7 @@ interface ComboboxOptions {
  *
  * @see https://www.w3.org/WAI/ARIA/apg/patterns/combobox/
  *
- * @param callbacks Callbacks for select and open/close events.
+ * @param callbacks Callbacks invoked on combobox events (e.g. option selection).
  * @param options Options for configuring the shared combobox behavior.
  * @param onTriggerAttach Optional callback invoked when the trigger is registered and the signal is ready.
  *                        Used by mode-specific wrappers (setupComboboxInput/Button) to automatically

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

@@ -1,6 +1,6 @@
 import type { ComboboxCallbacks, ComboboxHandle } from './types';
 /** Options for configuring the input-mode combobox controller. */
-export interface SetupComboboxInputOptions {
+export interface SetupComboboxInputOptions extends ComboboxCallbacks {
     /**
      * When true (default), the combobox automatically filters options as the user types.
      * Each registered `Combobox.Option` receives filter state updates and hides itself
@@ -21,9 +21,8 @@ export interface SetupComboboxInputOptions {
  * Handles: Home/End (text cursor), ArrowLeft/Right (clear active descendant),
  * filtering (on input and on open), and focus behavior.
  *
- * @param input     The input element to use as the combobox trigger.
- * @param callbacks Callbacks for select and open/close events.
- * @param options   Options for configuring the input-mode controller.
+ * @param input   The input element to use as the combobox trigger.
+ * @param options Options and callbacks for configuring the input-mode controller.
  * @returns A ComboboxHandle for interacting with the combobox.
  */
-export declare function setupComboboxInput(input: HTMLInputElement, callbacks: ComboboxCallbacks, options?: SetupComboboxInputOptions): ComboboxHandle;
+export declare function setupComboboxInput(input: HTMLInputElement, options: SetupComboboxInputOptions): ComboboxHandle;

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

@@ -0,0 +1,23 @@
+import type { ComboboxHandle } from './types';
+/** Setters invoked by `subscribeComboboxState` when handle events fire. */
+export interface ComboboxStateSetters {
+    /** Called immediately with the current loading state, then on every `loadingChange` event. */
+    setIsLoading: (value: boolean) => void;
+    /** Called on every `loadingAnnouncement` event (debounced 500ms after skeletons mount). */
+    setShouldAnnounce: (value: boolean) => void;
+    /** Called with `true` after a short delay when the combobox opens, and `false` immediately on close. */
+    setIsOpen: (value: boolean) => void;
+}
+/**
+ * Subscribe to the combobox handle events needed by `ComboboxState`.
+ *
+ * Manages three subscriptions:
+ * - `loadingChange` → `setIsLoading` (+ synchronous initial read of `handle.isLoading`)
+ * - `loadingAnnouncement` → `setShouldAnnounce`
+ * - `open` → `setIsOpen` (deferred by {@link OPEN_ANNOUNCEMENT_DELAY}ms on open, immediate on close)
+ *
+ * @param handle  The combobox handle to subscribe to.
+ * @param setters Framework-specific state setters.
+ * @returns A cleanup function that unsubscribes all events and clears timers.
+ */
+export declare function subscribeComboboxState(handle: ComboboxHandle, setters: ComboboxStateSetters): () => void;

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

@@ -41,10 +41,10 @@ export interface ComboboxEventMap {
 }
 /** Callbacks provided by the consumer (React/Vue) to react to combobox state changes. */
 export interface ComboboxCallbacks {
-    /** Called when an option is selected (click or keyboard). */
+    /** Called when an option is selected (click or keyboard). Receives the combobox handle for post-selection side effects. */
     onSelect(option: {
         value: string;
-    }): void;
+    }, handle: ComboboxHandle): void;
 }
 /** Handle returned by `setupCombobox`. Used by framework wrappers and mode controllers. */
 export interface ComboboxHandle {

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

@@ -0,0 +1,12 @@
+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>) => {
+    element: HTMLElement;
+    header: HTMLElement | null;
+    props: any;
+    wrapper: Partial<import("../../../testing").SetupResult>;
+};
+declare const _default: (renderOptions: SetupOptions<any>) => void;
+export default _default;

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

@@ -0,0 +1,70 @@
+import type { HasClassName, LumxClassName, HasCloseMode, HasTheme, CommonRef, GenericProps, JSXElement } from '../../types';
+/**
+ * Defines the props of the component.
+ */
+export interface ExpansionPanelProps extends HasClassName, HasCloseMode, HasTheme {
+    /** Whether the expansion panel has a background. */
+    hasBackground?: boolean;
+    /** Whether the header has a divider. */
+    hasHeaderDivider?: boolean;
+    /** Whether the component is open or not. */
+    isOpen?: boolean;
+    /** Label text (overwritten if a `<header>` is provided in the children). */
+    label?: string;
+    /** On open callback. */
+    handleOpen?: (event: any) => void;
+    /** On close callback. */
+    handleClose?: (event: any) => void;
+    /** Props to pass to the toggle button (minus those already set by the ExpansionPanel props). */
+    toggleButtonProps: any;
+    /** On toggle open or close callback. */
+    handleToggleOpen?(shouldOpen: boolean, event: any): void;
+    /** Children */
+    children?: JSXElement;
+    /** Ref forwarded to the root `<section>` element. */
+    ref?: CommonRef;
+    /** Ref forwarded to the collapsible wrapper `<div>`. */
+    wrapperRef?: CommonRef;
+    /** Props spread onto the header content `<div>` (e.g. `aria-*`, `data-*`). */
+    headerProps: GenericProps;
+    /** Content rendered inside the header content area. */
+    headerContent?: JSXElement;
+    /** Optional drag handle element rendered at the start of the header. */
+    dragHandle?: JSXElement;
+    /** Content rendered inside the collapsible content area. */
+    content?: JSXElement;
+    /** Optional footer element rendered below the content. */
+    footer?: JSXElement;
+    /** IconButton component injected by the framework wrapper (React or Vue). */
+    IconButton: any;
+    /** Whether the children should remain mounted (visible in the DOM) while the panel is closed. */
+    isChildrenVisible?: boolean;
+}
+export type ExpansionPanelPropsToOverride = 'handleOpen' | 'handleClose' | 'toggleButtonProps' | 'handleToggleOpen' | 'wrapperRef' | 'headerProps' | 'headerContent' | 'dragHandle' | 'content' | 'IconButton' | 'isChildrenVisible' | 'footer';
+/**
+ * Component display name.
+ */
+export declare const COMPONENT_NAME = "ExpansionPanel";
+/**
+ * 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;
+};
+/**
+ * Component default props.
+ */
+export declare const DEFAULT_PROPS: Partial<ExpansionPanelProps>;
+/**
+ * ExpansionPanel component.
+ *
+ * @param  props Component props.
+ * @param  ref   Component ref.
+ * @return React element.
+ */
+export declare const ExpansionPanel: (props: ExpansionPanelProps) => import("react").JSX.Element;

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

@@ -0,0 +1,13 @@
+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;
+    mosaic: HTMLElement;
+    thumbnails: HTMLElement[];
+    overlay: HTMLElement | null;
+    wrapper: Partial<import("../../../testing").SetupResult>;
+};
+declare const _default: (renderOptions: SetupOptions<any>) => void;
+export default _default;

package/js/components/Tabs/TabList.d.ts

@@ -0,0 +1,39 @@
+import { Alignment } from '../../constants';
+import { CommonRef, HasClassName, HasTheme, JSXElement } from '../../types';
+export declare enum TabListLayout {
+    clustered = "clustered",
+    fixed = "fixed"
+}
+/**
+ * Defines the props of the component.
+ */
+export interface TabListProps extends HasClassName, HasTheme {
+    /** ARIA label (purpose of the set of tabs). */
+    ['aria-label']: string;
+    /** Tab list. */
+    children: JSXElement;
+    /** Layout of the tabs in the list. */
+    layout?: TabListLayout;
+    /** Position of the tabs in the list (requires 'clustered' layout). */
+    position?: Alignment;
+    /** ref to the wrapper element */
+    ref?: CommonRef;
+}
+/**
+ * Component display name.
+ */
+export declare const COMPONENT_NAME = "TabList";
+/**
+ * Component default props.
+ */
+export declare const DEFAULT_PROPS: Partial<TabListProps>;
+/**
+ * TabList component.
+ *
+ * Implements WAI-ARIA `tablist` role {@see https://www.w3.org/TR/wai-aria-practices-1.1/examples/tabs/tabs-1/tabs.html#rps_label}
+ *
+ * @param  props Component props.
+ * @param  ref   Component ref.
+ * @return React element.
+ */
+export declare const TabList: (props: TabListProps) => import("react").JSX.Element;

package/js/components/Tabs/TabListTests.d.ts

@@ -0,0 +1,12 @@
+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;
+    tabList: HTMLElement;
+    links: HTMLElement | null;
+    wrapper: Partial<import("../../../testing").SetupResult>;
+};
+declare const _default: (renderOptions: SetupOptions<any>) => void;
+export default _default;

package/js/components/Tabs/TabPanelTests.d.ts

@@ -0,0 +1,11 @@
+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;
+    tabPanel: HTMLElement;
+    wrapper: Partial<import("../../../testing").SetupResult>;
+};
+declare const _default: (renderOptions: SetupOptions<any>) => void;
+export default _default;

package/js/components/Tabs/TabProviderTestUtils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Test util module. Do not import in production code!
+ */
+export declare const createTabTestUtils: ({ screen, within }: {
+    screen: any;
+    within: any;
+}) => {
+    query: {
+        tabList: (name: string) => any;
+        tabs: (tabList?: any) => any;
+        tab: (name: string, tabList?: any) => any;
+        tabPanel: (name: string) => any;
+    };
+    checkTabActive: (activeTabName: string, { isLazy }?: {
+        isLazy?: boolean | undefined;
+    }) => void;
+};

package/js/components/Tabs/state.d.ts

@@ -0,0 +1,34 @@
+export type TabType = 'tab' | 'tabPanel';
+export interface State {
+    isLazy: boolean;
+    shouldActivateOnFocus: boolean;
+    activeTabIndex: number;
+    ids: Record<TabType, string[]>;
+}
+export declare const INIT_STATE: State;
+export type Action = {
+    type: 'update';
+    payload: Partial<State>;
+} | {
+    type: 'setActiveTabIndex';
+    payload: number;
+} | {
+    type: 'register';
+    payload: {
+        type: TabType;
+        id: string;
+    };
+} | {
+    type: 'unregister';
+    payload: {
+        type: TabType;
+        id: string;
+    };
+};
+export declare const reducer: (state: State, action: Action) => State;
+export type TabState = Pick<Required<State>, 'isLazy' | 'shouldActivateOnFocus'> & {
+    isActive: boolean;
+    tabId: string;
+    tabPanelId: string;
+    changeToTab(): void;
+};

package/lumx.css

@@ -8914,7 +8914,7 @@ table {
 
 /* Section
    ========================================================================== */
-.lumx-list-section:not(:first-child):not(.lumx-list-section:not([hidden]) + .lumx-list-section):not(.lumx-list-divider + .lumx-list-section)::before {
+.lumx-list-section:not([hidden]) ~ .lumx-list-section:not(.lumx-list-section:not([hidden]) + .lumx-list-section):not(.lumx-list-divider + .lumx-list-section)::before {
   content: "";
   display: block;
   height: 1px;

package/package.json

@@ -7,7 +7,7 @@
     },
     "dependencies": {
         "@floating-ui/dom": "^1.7.5",
-        "@lumx/icons": "^4.9.0-alpha.1",
+        "@lumx/icons": "^4.9.0-alpha.3",
         "classnames": "^2.3.2",
         "focus-visible": "^5.0.2",
         "lodash": "4.17.23",
@@ -69,7 +69,7 @@
         "update-version-changelog": "yarn version-changelog ../../CHANGELOG.md"
     },
     "sideEffects": false,
-    "version": "4.9.0-alpha.1",
+    "version": "4.9.0-alpha.3",
     "devDependencies": {
         "@rollup/plugin-typescript": "^12.3.0",
         "@testing-library/dom": "^10.4.1",

package/scss/components/list/_mixins.scss

@@ -144,10 +144,12 @@
     $divider: '.#{$lumx-base-prefix}-list-divider';
     $section: &;
 
-    // Insert a divider before each section NOT directly following another visible section or an explicit divider.
-    // Avoids double dividers when two visible sections are adjacent or when a ListDivider separates them.
-    // Uses #{$section}:not([hidden]) so that hidden sections in between don't prevent the divider.
-    &:not(:first-child):not(#{$section}:not([hidden]) + &):not(#{$divider} + &) {
+    // Insert a divider before each section that:
+    // 1. Is not directly following another visible section (avoids double dividers)
+    // 2. Is not directly following an explicit divider
+    // 3. Has at least one preceding visible section (uses `~` general sibling combinator
+    //    so hidden-first-sections don't get a spurious top divider)
+    #{$section}:not([hidden]) ~ &:not(#{$section}:not([hidden]) + &):not(#{$divider} + &) {
         &::before {
             content: '';
             display: block;