@lumx/react 3.20.1-alpha.45 → 3.20.1-alpha.47

package/_internal/{useClassnames.js → Cd8LPzmx.js}

@@ -2,7 +2,7 @@ import React__default, { useEffect, useContext, createContext, useMemo, useRef }
 import isEmpty from 'lodash/isEmpty';
 import { jsx, Fragment } from 'react/jsx-runtime';
 import { createPortal } from 'react-dom';
-import { cls } from '@lumx/core/js/utils';
+import { classNames } from '@lumx/core/js/utils';
 
 const EVENT_TYPES = ['mousedown', 'touchstart'];
 function isClickAway(targets, refs) {
@@ -157,48 +157,49 @@ function useDisabledStateContext() {
 }
 
 /**
- * Hook that retrieves several utilities for the classnames feature.
- * @param classname - base component class name
- * @returns utility functions
+ * Hook that provides BEM class name utilities for a component.
+ *
+ * @param className - Base component class name (kebab-case)
+ * @returns Object with `block` and `element` utility functions
+ *
+ * @example
+ * const { block, element } = useClassnames('my-component');
  */
-function useClassnames(classname) {
+function useClassnames(className) {
   return useMemo(() => {
     return {
       /**
-       * Returns the BEM class for the given block (and modifier if it is defined)
-       *
-       * Executing `block()` returns`CLASSNAME`
-       *
-       * Executing `block('modifier')` returns  `CLASSNAME CLASSNAME--modifier`
+       * Generates BEM block class names with optional modifiers.
        *
-       * Executing `block({ modifier1: true, modifier2: false })` returns `CLASSNAME CLASSNAME--modifier1`
+       * @param modifier - Modifier string, object, or additional class names
+       * @param additionalClasses - Additional CSS classes to append
+       * @returns Generated class name string
        *
-       * Executing `block(['className'])` returns `CLASSNAME className`
-       *
-       * @param modifier - string or Record<string, boolean> or list of css classes
-       * @param additionalClasses - string | string[] - list of additional classes to be added
-       * @returns string
+       * @example
+       * block() // 'my-component'
+       * block('active') // 'my-component my-component--active'
+       * block({ active: true, disabled: false }) // 'my-component my-component--active'
+       * block(['custom-class']) // 'my-component custom-class'
        */
-      block: cls.bem.block(classname),
+      block: classNames.bem.block(className),
       /**
-       * Returns the BEM class for the given element (and modifier if it is defined)
-       *
-       * Executing `element('element')` returns `CLASSNAME__element`
-       *
-       * Executing `element('element', 'modifier')` returns `CLASSNAME__element CLASSNAME__element--modifier`
-       *
-       * Executing `element('element', { modifier1: true, modifier2: false })` returns `CLASSNAME__element CLASSNAME__element--modifier1`
+       * Generates BEM element class names with optional modifiers.
        *
-       * Executing `element('element', ['classname'])` returns `CLASSNAME__element` class name
+       * @param elementName - Element name
+       * @param modifier - Modifier string, object, or additional class names
+       * @param additionalClasses - Additional CSS classes to append
+       * @returns Generated class name string
        *
-       * @param modifier - string or Record<string, boolean> or list of css classes
-       * @param additionalClasses - string | string[] - list of additional classes to be added
-       * @returns string
+       * @example
+       * element('header') // 'my-component__header'
+       * element('header', 'large') // 'my-component__header my-component__header--large'
+       * element('header', { large: true, small: false }) // 'my-component__header my-component__header--large'
+       * element('header', ['custom-class']) // 'my-component__header custom-class'
        */
-      element: cls.bem.element(classname)
+      element: classNames.bem.element(className)
     };
-  }, [classname]);
+  }, [className]);
 }
 
 export { ClickAwayProvider as C, DisabledStateProvider as D, Portal as P, PortalProvider as a, useClassnames as b, useDisabledStateContext as u };
-//# sourceMappingURL=useClassnames.js.map
+//# sourceMappingURL=Cd8LPzmx.js.map

package/_internal/Cd8LPzmx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cd8LPzmx.js","sources":["../../src/hooks/useClickAway.tsx","../../src/utils/ClickAwayProvider/ClickAwayProvider.tsx","../../src/utils/Portal/PortalProvider.tsx","../../src/utils/Portal/Portal.tsx","../../src/utils/disabled/DisabledStateContext.tsx","../../src/utils/className/useClassnames.ts"],"sourcesContent":["import { RefObject, useEffect } from 'react';\n\nimport { Falsy } from '@lumx/react/utils/type';\n\nimport isEmpty from 'lodash/isEmpty';\n\nconst EVENT_TYPES = ['mousedown', 'touchstart'];\n\nfunction isClickAway(targets: HTMLElement[], refs: Array<RefObject<HTMLElement>>): boolean {\n    // The targets elements are not contained in any of the listed element references.\n    return !refs.some((ref) => targets.some((target) => ref?.current?.contains(target)));\n}\n\nexport interface ClickAwayParameters {\n    /**\n     * A callback function to call when the user clicks away from the elements.\n     */\n    callback: EventListener | Falsy;\n    /**\n     * Elements considered within the click away context (clicking outside them will trigger the click away callback).\n     */\n    childrenRefs: RefObject<Array<RefObject<HTMLElement>>>;\n}\n\n/**\n * Listen to clicks away from the given elements and callback the passed in function.\n *\n * Warning: If you need to detect click away on nested React portals, please use the `ClickAwayProvider` component.\n */\nexport function useClickAway({ callback, childrenRefs }: ClickAwayParameters): void {\n    useEffect(() => {\n        const { current: currentRefs } = childrenRefs;\n        if (!callback || !currentRefs || isEmpty(currentRefs)) {\n            return undefined;\n        }\n        const listener: EventListener = (evt) => {\n            const targets = [evt.composedPath?.()[0], evt.target] as HTMLElement[];\n            if (isClickAway(targets, currentRefs)) {\n                callback(evt);\n            }\n        };\n\n        EVENT_TYPES.forEach((evtType) => document.addEventListener(evtType, listener));\n        return () => {\n            EVENT_TYPES.forEach((evtType) => document.removeEventListener(evtType, listener));\n        };\n    }, [callback, childrenRefs]);\n}\n","import { createContext, RefObject, useContext, useEffect, useMemo, useRef } from 'react';\nimport { ClickAwayParameters, useClickAway } from '@lumx/react/hooks/useClickAway';\n\ninterface ContextValue {\n    childrenRefs: Array<RefObject<HTMLElement>>;\n    addRefs(...newChildrenRefs: Array<RefObject<HTMLElement>>): void;\n}\n\nconst ClickAwayAncestorContext = createContext<ContextValue | null>(null);\n\ninterface ClickAwayProviderProps extends ClickAwayParameters {\n    /**\n     * (Optional) Element that should be considered as part of the parent\n     */\n    parentRef?: RefObject<HTMLElement>;\n    /**\n     * Children\n     */\n    children?: React.ReactNode;\n}\n\n/**\n * Component combining the `useClickAway` hook with a React context to hook into the React component tree and make sure\n * we take into account both the DOM tree and the React tree to detect click away.\n *\n * @return the react component.\n */\nexport const ClickAwayProvider: React.FC<ClickAwayProviderProps> = ({\n    children,\n    callback,\n    childrenRefs,\n    parentRef,\n}) => {\n    const parentContext = useContext(ClickAwayAncestorContext);\n    const currentContext = useMemo(() => {\n        const context: ContextValue = {\n            childrenRefs: [],\n            /**\n             * Add element refs to the current context and propagate to the parent context.\n             */\n            addRefs(...newChildrenRefs) {\n                // Add element refs that should be considered as inside the click away context.\n                context.childrenRefs.push(...newChildrenRefs);\n\n                if (parentContext) {\n                    // Also add then to the parent context\n                    parentContext.addRefs(...newChildrenRefs);\n                    if (parentRef) {\n                        // The parent element is also considered as inside the parent click away context but not inside the current context\n                        parentContext.addRefs(parentRef);\n                    }\n                }\n            },\n        };\n        return context;\n    }, [parentContext, parentRef]);\n\n    useEffect(() => {\n        const { current: currentRefs } = childrenRefs;\n        if (!currentRefs) {\n            return;\n        }\n        currentContext.addRefs(...currentRefs);\n    }, [currentContext, childrenRefs]);\n\n    useClickAway({ callback, childrenRefs: useRef(currentContext.childrenRefs) });\n    return <ClickAwayAncestorContext.Provider value={currentContext}>{children}</ClickAwayAncestorContext.Provider>;\n};\nClickAwayProvider.displayName = 'ClickAwayProvider';\n","import React from 'react';\n\ntype Container = DocumentFragment | Element;\n\n/**\n * Portal initializing function.\n * If it does not provide a container, the Portal children will render in classic React tree and not in a portal.\n */\nexport type PortalInit = () => {\n    container?: Container;\n    teardown?: () => void;\n};\n\nexport const PortalContext = React.createContext<PortalInit>(() => ({ container: document.body }));\n\nexport interface PortalProviderProps {\n    children?: React.ReactNode;\n    value: PortalInit;\n}\n\n/**\n * Customize where <Portal> wrapped elements render (tooltip, popover, dialog, etc.)\n */\nexport const PortalProvider: React.FC<PortalProviderProps> = PortalContext.Provider;\n","import React from 'react';\nimport { createPortal } from 'react-dom';\nimport { PortalContext } from './PortalProvider';\n\nexport interface PortalProps {\n    enabled?: boolean;\n    children: React.ReactNode;\n}\n\n/**\n * Render children in a portal outside the current DOM position\n * (defaults to `document.body` but can be customized with the PortalContextProvider)\n */\nexport const Portal: React.FC<PortalProps> = ({ children, enabled = true }) => {\n    const init = React.useContext(PortalContext);\n    const context = React.useMemo(\n        () => {\n            return enabled ? init() : null;\n        },\n        // Only update on 'enabled'\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n        [enabled],\n    );\n\n    React.useLayoutEffect(() => {\n        return context?.teardown;\n    }, [context?.teardown, enabled]);\n\n    if (!context?.container) {\n        return <>{children}</>;\n    }\n    return createPortal(children, context.container);\n};\n","import React, { useContext } from 'react';\n\n/** Disable state */\ntype DisabledStateContextValue =\n    | {\n          state: 'disabled';\n      }\n    | { state: undefined | null };\n\nexport const DisabledStateContext = React.createContext<DisabledStateContextValue>({ state: null });\n\nexport type DisabledStateProviderProps = DisabledStateContextValue & {\n    children: React.ReactNode;\n};\n\n/**\n * Disabled state provider.\n * All nested LumX Design System components inherit this disabled state.\n */\nexport function DisabledStateProvider({ children, ...value }: DisabledStateProviderProps) {\n    return <DisabledStateContext.Provider value={value}>{children}</DisabledStateContext.Provider>;\n}\n\n/**\n * Get DisabledState context value\n */\nexport function useDisabledStateContext(): DisabledStateContextValue {\n    return useContext(DisabledStateContext);\n}\n","import { useMemo } from 'react';\n\nimport type { KebabCase } from '@lumx/core/js/types';\nimport { classNames } from '@lumx/core/js/utils';\n\n/**\n * Hook that provides BEM class name utilities for a component.\n *\n * @param className - Base component class name (kebab-case)\n * @returns Object with `block` and `element` utility functions\n *\n * @example\n * const { block, element } = useClassnames('my-component');\n */\nexport function useClassnames<C extends string>(className: KebabCase<C>) {\n    return useMemo(() => {\n        return {\n            /**\n             * Generates BEM block class names with optional modifiers.\n             *\n             * @param modifier - Modifier string, object, or additional class names\n             * @param additionalClasses - Additional CSS classes to append\n             * @returns Generated class name string\n             *\n             * @example\n             * block() // 'my-component'\n             * block('active') // 'my-component my-component--active'\n             * block({ active: true, disabled: false }) // 'my-component my-component--active'\n             * block(['custom-class']) // 'my-component custom-class'\n             */\n            block: classNames.bem.block(className),\n            /**\n             * Generates BEM element class names with optional modifiers.\n             *\n             * @param elementName - Element name\n             * @param modifier - Modifier string, object, or additional class names\n             * @param additionalClasses - Additional CSS classes to append\n             * @returns Generated class name string\n             *\n             * @example\n             * element('header') // 'my-component__header'\n             * element('header', 'large') // 'my-component__header my-component__header--large'\n             * element('header', { large: true, small: false }) // 'my-component__header my-component__header--large'\n             * element('header', ['custom-class']) // 'my-component__header custom-class'\n             */\n            element: classNames.bem.element(className),\n        };\n    }, [className]);\n}\n"],"names":["EVENT_TYPES","isClickAway","targets","refs","some","ref","target","current","contains","useClickAway","callback","childrenRefs","useEffect","currentRefs","isEmpty","undefined","listener","evt","composedPath","forEach","evtType","document","addEventListener","removeEventListener","ClickAwayAncestorContext","createContext","ClickAwayProvider","children","parentRef","parentContext","useContext","currentContext","useMemo","context","addRefs","newChildrenRefs","push","useRef","_jsx","Provider","value","displayName","PortalContext","React","container","body","PortalProvider","Portal","enabled","init","useLayoutEffect","teardown","_Fragment","createPortal","DisabledStateContext","state","DisabledStateProvider","useDisabledStateContext","useClassnames","className","block","classNames","bem","element"],"mappings":"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"}

package/index.js

@@ -8,8 +8,8 @@ import { mdiAlertCircle } from '@lumx/icons/esm/alert-circle';
 import { mdiCheckCircle } from '@lumx/icons/esm/check-circle';
 import { mdiInformation } from '@lumx/icons/esm/information';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
-import { u as useDisabledStateContext, b as useClassnames, P as Portal, C as ClickAwayProvider } from './_internal/useClassnames.js';
-import { cls, onEnterPressed, onEscapePressed, resolveColorWithVariants, onButtonPressed, detectHorizontalSwipe } from '@lumx/core/js/utils';
+import { u as useDisabledStateContext, b as useClassnames, P as Portal, C as ClickAwayProvider } from './_internal/Cd8LPzmx.js';
+import { classNames, onEnterPressed, onEscapePressed, onButtonPressed, detectHorizontalSwipe } from '@lumx/core/js/utils';
 import last from 'lodash/last';
 import pull from 'lodash/pull';
 import get from 'lodash/get';
@@ -782,7 +782,7 @@ const RawClickable = forwardRefPolymorphic((props, ref) => {
 const COMPONENT_NAME$1f = 'ButtonRoot';
 const BUTTON_WRAPPER_CLASSNAME = `lumx-button-wrapper`;
 const BUTTON_CLASSNAME = `lumx-button`;
-const wrapperBlock = cls.bem.block(BUTTON_WRAPPER_CLASSNAME);
+const wrapperBlock = classNames.bem.block(BUTTON_WRAPPER_CLASSNAME);
 
 /**
  * Render a button wrapper with the ButtonRoot inside.
@@ -1916,7 +1916,7 @@ const DatePickerControlled = forwardRef((props, ref) => {
       label: /*#__PURE__*/jsxs(Fragment, {
         children: [/*#__PURE__*/jsx("span", {
           "aria-live": labelAriaLive,
-          className: onMonthChange ? cls.visuallyHidden() : undefined,
+          className: onMonthChange ? classNames.visuallyHidden() : undefined,
           dir: "auto",
           children: monthYear
         }), onMonthChange && /*#__PURE__*/jsx(FlexBox, {
@@ -1987,7 +1987,7 @@ const DatePickerControlled = forwardRef((props, ref) => {
                   "aria-hidden": true,
                   children: formatDayNumber(locale, date)
                 }), /*#__PURE__*/jsx("span", {
-                  className: cls.visuallyHidden(),
+                  className: classNames.visuallyHidden(),
                   children: date.toLocaleDateString(locale, {
                     day: 'numeric',
                     month: 'long',
@@ -6256,7 +6256,7 @@ const useOverflowTooltipLabel = content => {
     // Not inside a tooltip
     !parentTooltip && labelElement &&
     // Not inside a visually hidden
-    !labelElement?.closest(`.${cls.visuallyHidden()}`) &&
+    !labelElement?.closest(`.${classNames.visuallyHidden()}`) &&
     // Text overflows
     labelElement.offsetWidth < labelElement.scrollWidth) {
       // Set tooltip label
@@ -6350,7 +6350,7 @@ const Text = forwardRef((props, ref) => {
       'is-truncated': isTruncated && !isTruncatedMultiline,
       'is-truncated-multiline': isTruncatedMultiline,
       'no-wrap': noWrap
-    }, [cls.typography(typography), cls.font(color, colorVariant), className]),
+    }, [classNames.typography(typography), classNames.font(color, colorVariant), className]),
     title: tooltipLabel,
     style: {
       ...truncateLinesStyle,
@@ -6622,6 +6622,13 @@ GridColumn.displayName = COMPONENT_NAME$S;
 GridColumn.className = CLASSNAME$S;
 GridColumn.defaultProps = DEFAULT_PROPS$K;
 
+/** Resolve color & color variant from a `ColorWithVariants` and optionally a `ColorVariant`. */
+function resolveColorWithVariants(colorWithVariants, colorVariant) {
+  if (!colorWithVariants) return [undefined, colorVariant];
+  const [color, baseColorVariant] = colorWithVariants.split('-');
+  return [color, colorVariant || baseColorVariant];
+}
+
 /**
  * Component display name.
  */
@@ -7691,7 +7698,7 @@ const InlineList = forwardRef((props, ref) => {
       ref: ref,
       className: block({
         wrap: Boolean(wrap)
-      }, [className, cls.font(color, colorVariant), cls.typography(typography)])
+      }, [className, classNames.font(color, colorVariant), classNames.typography(typography)])
       // Lists with removed bullet style can lose their a11y list role on some browsers
       ,
       role: "list",
@@ -7828,7 +7835,7 @@ const InputLabel = forwardRef((props, ref) => {
       'is-required': isRequired,
       [`theme-${theme}`]: Boolean(theme),
       'has-custom-typography': Boolean(typography)
-    }, [className, cls.typography(typography)]),
+    }, [className, classNames.typography(typography)]),
     children: children
   });
 });
@@ -8023,7 +8030,7 @@ const Link = forwardRef((props, ref) => {
       [`color-${color}`]: Boolean(color),
       [`color-variant-${colorVariant}`]: Boolean(colorVariant),
       'has-typography': Boolean(typography)
-    }, [className, cls.typography(typography)]),
+    }, [className, classNames.typography(typography)]),
     children: wrapChildrenIconWithSpaces(/*#__PURE__*/jsxs(Fragment, {
       children: [leftIcon && /*#__PURE__*/jsx(Icon, {
         icon: leftIcon,
@@ -10337,7 +10344,7 @@ const SideNavigation = forwardRef((props, ref) => {
   return /*#__PURE__*/jsx("ul", {
     ref: ref,
     ...forwardedProps,
-    className: block([className, theme === Theme.dark && cls.font('light')]),
+    className: block([className, theme === Theme.dark && classNames.font('light')]),
     children: content
   });
 });
@@ -13471,7 +13478,7 @@ const Tooltip = forwardRef((props, ref) => {
         className: block({
           [`position-${position}`]: Boolean(position),
           'is-initializing': !styles.popper?.transform
-        }, [className, isHidden && cls.visuallyHidden()]),
+        }, [className, isHidden && classNames.visuallyHidden()]),
         style: {
           ...(isHidden ? undefined : styles.popper),
           zIndex
@@ -13620,7 +13627,7 @@ const Uploader = forwardRef((props, ref) => {
     }), fileInputProps && /*#__PURE__*/jsx("input", {
       type: "file",
       id: inputId,
-      className: element('input', [cls.visuallyHidden()]),
+      className: element('input', [classNames.visuallyHidden()]),
       ...disabledStateProps,
       ...fileInputProps,
       readOnly: isAnyDisabled,