@lumx/core 4.9.0-next.8 → 4.9.0-next.9

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/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/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-next.8",
+        "@lumx/icons": "^4.9.0-next.9",
         "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-next.8",
+    "version": "4.9.0-next.9",
     "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;