@lumx/vue 4.11.0-next.0 → 4.11.0-next.2

package/components/flex-box/FlexBox.d.ts

@@ -3,12 +3,6 @@ import { VueToJSXProps } from '../../utils/VueToJSX';
 export type FlexBoxProps = VueToJSXProps<UIProps, 'vAlign' | 'hAlign'> & {
     /** Customize the root element. */
     as?: string;
-    /**
-     * @deprecated please use `class`
-     * custom class name, used for compatibility when using
-     * FlexBox as a nested component.
-     */
-    className?: string;
     /** FlexBox vertical alignment */
     verticalAlign?: UIProps['vAlign'];
     /** FlexBox horizontal alignment */
@@ -26,12 +20,6 @@ declare const FlexBox: import('vue').DefineSetupFnComponent<FlexBoxProps, {}, {}
 } & {
     /** Customize the root element. */
     as?: string;
-    /**
-     * @deprecated please use `class`
-     * custom class name, used for compatibility when using
-     * FlexBox as a nested component.
-     */
-    className?: string;
     /** FlexBox vertical alignment */
     verticalAlign?: UIProps["vAlign"];
     /** FlexBox horizontal alignment */

package/composables/useAttrFallback.d.ts

@@ -0,0 +1,28 @@
+import { ComputedRef, MaybeRefOrGetter } from 'vue';
+/**
+ * Composable that falls back to an `$attrs` value when the Vue prop is absent.
+ *
+ * When a core JSX component renders a Vue sub-component, it passes props using React naming
+ * conventions (e.g. `className`, `tabIndex`). Since these names are not declared Vue props,
+ * they land in `$attrs`. This composable reads the fallback attr and merges it with the
+ * corresponding Vue prop value using a caller-supplied merge function (or `??` by default).
+ *
+ * Usage inside `defineComponent` setup:
+ * ```tsx
+ * // With default merge (vueProp ?? attrFallback):
+ * const tabIndex = useAttrFallback(() => attrs.tabindex, 'tabIndex');
+ *
+ * // With custom merge function:
+ * const className = useAttrFallback(
+ *     () => props.class,
+ *     'className',
+ *     (vue, fallback) => classNames.join(vue, fallback as string | undefined) || undefined,
+ * );
+ * ```
+ *
+ * @param  vueProp      The Vue prop value (or a getter/ref returning it).
+ * @param  attrFallback The attribute name to read from `$attrs` as the fallback.
+ * @param  merge        Optional merge function. Defaults to `vueProp ?? attrFallback`.
+ * @return Computed ref holding the merged value.
+ */
+export declare function useAttrFallback<T>(vueProp: MaybeRefOrGetter<T>, attrFallback: string, merge?: (vuePropValue: T, attrFallbackValue: unknown) => T): ComputedRef<T>;

package/composables/useClassName.d.ts

@@ -0,0 +1,15 @@
+import { ComputedRef, MaybeRefOrGetter } from 'vue';
+/**
+ * Composable that merges the Vue `class` prop with the `className` attribute (for React compat).
+ *
+ * Usage inside `defineComponent` setup:
+ * ```tsx
+ * const className = useClassName(() => props.class);
+ * // Then use className.value instead of props.class when forwarding to the core UI:
+ * return () => <SomeUI {...props} className={className.value} />;
+ * ```
+ *
+ * @param  classProp The Vue `class` prop value (or a getter/ref returning it).
+ * @return Computed ref holding the merged class string (or undefined when empty).
+ */
+export declare function useClassName(classProp: MaybeRefOrGetter<string | undefined>): ComputedRef<string | undefined>;

package/composables/useRovingTabIndexContainer.d.ts

@@ -16,10 +16,17 @@ export interface UseRovingTabIndexContainerOptions {
      * Disabled items are skipped during keyboard navigation.
      */
     itemDisabledSelector?: string;
+    /**
+     * Attribute name indicating the selected item (e.g. `'aria-selected'`, `'aria-checked'`).
+     * When set, the roving tabindex will keep `tabindex="0"` in sync with the item
+     * whose attribute value is `"true"`.
+     * Default: `'aria-selected'`.
+     */
+    itemSelectedAttr?: string;
 }
 /**
  * Vue composable equivalent of React's useRovingTabIndexContainer.
  * Sets up roving tab index keyboard navigation on a container element.
  * Automatically tears down when the container is removed or the composable is unmounted.
  */
-export declare function useRovingTabIndexContainer({ containerRef, itemSelector, onItemFocused, direction, itemDisabledSelector, }: UseRovingTabIndexContainerOptions): void;
+export declare function useRovingTabIndexContainer({ containerRef, itemSelector, onItemFocused, direction, itemDisabledSelector, itemSelectedAttr, }: UseRovingTabIndexContainerOptions): void;