react-better-html 1.1.237 → 1.1.238

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { Color, BetterCoreProviderConfig, DeepPartialRecord, OmitProps, BetterCoreConfig, IconName, AnyOtherString, PartialRecord, AssetName, LoaderName, PickValue, Country } from 'react-better-core';
-export { API, APIConfigItem, APIError, APIResponse, AnyOtherString, AssetName, AssetsConfig, Color, ColorName, ColorTheme, Colors, Country, DeepPartialRecord, ExcludeOptions, HttpHeaders as HttpHeader, HttpMethod, IconName, IconsConfig, LoaderConfig, LoaderName, OmitProps, PartialRecord, PickAllRequired, PickValue, Styles, Theme, ThemeConfig, Unsubscribe, UrlQuery, colorThemeControls, countries, darkenColor, desaturateColor, eventPreventDefault, eventPreventStop, eventStopPropagation, formatPhoneNumber, generateApi, generateEventEmitter, generateRandomString, getPluralWord, isApiError, lightenColor, loaderControls, log, saturateColor, useBooleanState, useDebounceState, useLoader, useLoaderControls, useTheme } from 'react-better-core';
+export { API, APIConfigItem, APIError, APIResponse, AnyOtherString, AssetName, AssetsConfig, Color, ColorName, ColorTheme, Colors, Country, DeepPartialRecord, ExcludeOptions, HttpHeaders as HttpHeader, HttpMethod, IconName, IconsConfig, LoaderConfig, LoaderName, OmitProps, PartialRecord, PickAllRequired, PickValue, Styles, Theme, ThemeConfig, Unsubscribe, UrlQuery, calculateColorContrast, colorThemeControls, countries, darkenColor, desaturateColor, eventPreventDefault, eventPreventStop, eventStopPropagation, formatPhoneNumber, generateApi, generateEventEmitter, generateRandomString, getPluralWord, isApiError, lightenColor, loaderControls, log, saturateColor, useBooleanState, useDebounceState, useLoader, useLoaderControls, useTheme } from 'react-better-core';
 import * as react from 'react';
 import { ComponentProps, ReactNode } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -582,6 +582,7 @@ type PageHolderProps = {
 type PageHolderComponentType = {
     (props: ComponentPropWithRef<HTMLDivElement, PageHolderProps>): React.ReactElement;
     center: (props: ComponentPropWithRef<HTMLDivElement, PageHolderProps & {
+        height?: React.CSSProperties["height"];
         pageBackgroundColor?: React.CSSProperties["backgroundColor"];
         pageBackgroundImage?: React.CSSProperties["backgroundImage"];
         contentMaxWidth?: React.CSSProperties["maxWidth"];
@@ -591,7 +592,7 @@ type PageHolderComponentType = {
         sideComponent?: React.ReactNode;
         /** @default "right" */
         sideComponentPosition?: "left" | "right";
-    }>) => React.ReactElement;
+    } & ComponentMarginProps>) => React.ReactElement;
 };
 declare const PageHolderComponent: PageHolderComponentType;
 declare const PageHolder: typeof PageHolderComponent & {
@@ -1036,6 +1037,9 @@ type SideMenuProps = {
     isLoading?: boolean;
     /** @default backgroundContent */
     backgroundColor?: React.CSSProperties["backgroundColor"];
+    /** @default primary */
+    activeItemColor?: string;
+    hoverItemColor?: string;
     gap?: React.CSSProperties["gap"];
     paddingTop?: React.CSSProperties["paddingTop"];
     paddingBottom?: React.CSSProperties["paddingBottom"];

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Color, BetterCoreProviderConfig, DeepPartialRecord, OmitProps, BetterCoreConfig, IconName, AnyOtherString, PartialRecord, AssetName, LoaderName, PickValue, Country } from 'react-better-core';
-export { API, APIConfigItem, APIError, APIResponse, AnyOtherString, AssetName, AssetsConfig, Color, ColorName, ColorTheme, Colors, Country, DeepPartialRecord, ExcludeOptions, HttpHeaders as HttpHeader, HttpMethod, IconName, IconsConfig, LoaderConfig, LoaderName, OmitProps, PartialRecord, PickAllRequired, PickValue, Styles, Theme, ThemeConfig, Unsubscribe, UrlQuery, colorThemeControls, countries, darkenColor, desaturateColor, eventPreventDefault, eventPreventStop, eventStopPropagation, formatPhoneNumber, generateApi, generateEventEmitter, generateRandomString, getPluralWord, isApiError, lightenColor, loaderControls, log, saturateColor, useBooleanState, useDebounceState, useLoader, useLoaderControls, useTheme } from 'react-better-core';
+export { API, APIConfigItem, APIError, APIResponse, AnyOtherString, AssetName, AssetsConfig, Color, ColorName, ColorTheme, Colors, Country, DeepPartialRecord, ExcludeOptions, HttpHeaders as HttpHeader, HttpMethod, IconName, IconsConfig, LoaderConfig, LoaderName, OmitProps, PartialRecord, PickAllRequired, PickValue, Styles, Theme, ThemeConfig, Unsubscribe, UrlQuery, calculateColorContrast, colorThemeControls, countries, darkenColor, desaturateColor, eventPreventDefault, eventPreventStop, eventStopPropagation, formatPhoneNumber, generateApi, generateEventEmitter, generateRandomString, getPluralWord, isApiError, lightenColor, loaderControls, log, saturateColor, useBooleanState, useDebounceState, useLoader, useLoaderControls, useTheme } from 'react-better-core';
 import * as react from 'react';
 import { ComponentProps, ReactNode } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -582,6 +582,7 @@ type PageHolderProps = {
 type PageHolderComponentType = {
     (props: ComponentPropWithRef<HTMLDivElement, PageHolderProps>): React.ReactElement;
     center: (props: ComponentPropWithRef<HTMLDivElement, PageHolderProps & {
+        height?: React.CSSProperties["height"];
         pageBackgroundColor?: React.CSSProperties["backgroundColor"];
         pageBackgroundImage?: React.CSSProperties["backgroundImage"];
         contentMaxWidth?: React.CSSProperties["maxWidth"];
@@ -591,7 +592,7 @@ type PageHolderComponentType = {
         sideComponent?: React.ReactNode;
         /** @default "right" */
         sideComponentPosition?: "left" | "right";
-    }>) => React.ReactElement;
+    } & ComponentMarginProps>) => React.ReactElement;
 };
 declare const PageHolderComponent: PageHolderComponentType;
 declare const PageHolder: typeof PageHolderComponent & {
@@ -1036,6 +1037,9 @@ type SideMenuProps = {
     isLoading?: boolean;
     /** @default backgroundContent */
     backgroundColor?: React.CSSProperties["backgroundColor"];
+    /** @default primary */
+    activeItemColor?: string;
+    hoverItemColor?: string;
     gap?: React.CSSProperties["gap"];
     paddingTop?: React.CSSProperties["paddingTop"];
     paddingBottom?: React.CSSProperties["paddingBottom"];

package/dist/index.js

@@ -57,6 +57,7 @@ __export(index_exports, {
   Tooltip: () => Tooltip_default,
   alertControls: () => alertControls,
   alertsPlugin: () => alertsPlugin,
+  calculateColorContrast: () => import_react_better_core30.calculateColorContrast,
   colorThemeControls: () => import_react_better_core30.colorThemeControls,
   countries: () => import_react_better_core30.countries,
   darkenColor: () => import_react_better_core30.darkenColor,
@@ -3356,6 +3357,7 @@ var PageHolderComponent = (0, import_react15.forwardRef)(function PageHolder({ n
   );
 });
 PageHolderComponent.center = (0, import_react15.forwardRef)(function Center({
+  height,
   pageBackgroundColor,
   pageBackgroundImage,
   contentMaxWidth,
@@ -3398,18 +3400,29 @@ PageHolderComponent.center = (0, import_react15.forwardRef)(function Center({
           }
         ),
         sideComponentPosition === "left" && withSideComponent && /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(Div_default, { width: "50%" }),
-        /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(Div_default.column, { position: "relative", width: `${withSideComponent ? 50 : 100}%`, alignItems: "center", zIndex: 2, children: /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
-          ContentTag,
+        /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
+          Div_default.column,
           {
-            width: `calc(100% - ${theme2.styles.space * 2}px)`,
-            maxWidth: !noMaxContentWidth ? contentMaxWidth ?? app.contentMaxWidth / 2 : void 0,
-            marginInline: theme2.styles.space,
-            marginBlock: theme2.styles.space,
-            ...props,
-            ref,
-            children
+            position: "relative",
+            width: `${withSideComponent ? 50 : 100}%`,
+            height,
+            alignItems: "center",
+            zIndex: 2,
+            children: /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
+              ContentTag,
+              {
+                width: `calc(100% - ${theme2.styles.space * 2}px)`,
+                maxWidth: !noMaxContentWidth ? contentMaxWidth ?? app.contentMaxWidth / 2 : void 0,
+                height,
+                marginInline: theme2.styles.space,
+                marginBlock: theme2.styles.space,
+                ...props,
+                ref,
+                children
+              }
+            )
           }
-        ) }),
+        ),
         sideComponentPosition === "right" && withSideComponent && /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(Div_default, { width: "50%" }),
         withSideComponent && /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
           Div_default,
@@ -7398,7 +7411,13 @@ var useSideMenuContext = () => {
   }
   return context;
 };
-var MenuItemComponent = (0, import_react31.memo)(function MenuItemComponent2({ item, backgroundColor, onClick }) {
+var MenuItemComponent = (0, import_react31.memo)(function MenuItemComponent2({
+  item,
+  backgroundColor,
+  activeItemColor,
+  hoverItemColor,
+  onClick
+}) {
   const reactRouterDomPlugin2 = usePlugin("react-router-dom");
   if (!reactRouterDomPlugin2) {
     throw new Error(
@@ -7439,6 +7458,7 @@ var MenuItemComponent = (0, import_react31.memo)(function MenuItemComponent2({ i
   const lineHeight = 20;
   const lineWidth = 2;
   const lineEndRadius = iconSize / 2 + iconGap * 2;
+  const backgroundColorContrast = activeItemColor ? (0, import_react_better_core29.calculateColorContrast)(activeItemColor, theme2.colors.primary) : 21;
   const content = /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(
     Tooltip_default,
     {
@@ -7457,24 +7477,33 @@ var MenuItemComponent = (0, import_react31.memo)(function MenuItemComponent2({ i
           alignItems: "center",
           gap: iconGap,
           whiteSpace: "nowrap",
-          backgroundColor: isActive ? colorTheme === "dark" ? (0, import_react_better_core29.lightenColor)(theme2.colors.primary, 0.7) : (0, import_react_better_core29.lightenColor)(theme2.colors.primary, 0.85) : readyBackgroundColor,
+          backgroundColor: isActive ? activeItemColor ?? (colorTheme === "dark" ? (0, import_react_better_core29.lightenColor)(theme2.colors.primary, 0.7) : (0, import_react_better_core29.lightenColor)(theme2.colors.primary, 0.85)) : readyBackgroundColor,
+          backgroundColorHover: hoverItemColor,
           borderRadius: theme2.styles.borderRadius,
           paddingBlock,
           paddingLeft: isCollapsed ? theme2.styles.space : paddingLeft,
           paddingRight: theme2.styles.space,
-          filterHover: `brightness(${colorTheme === "dark" ? isActive ? 0.8 : 1.3 : isActive ? 0.8 : 0.95})`,
+          filterHover: !hoverItemColor ? `brightness(${colorTheme === "dark" ? isActive ? 0.8 : 1.3 : isActive ? 0.8 : 0.95})` : void 0,
           overflow: isCollapsed ? "hidden" : void 0,
           cursor: item.disabled ? "not-allowed" : "pointer",
           opacity: item.disabled ? 0.6 : void 0,
           onClick: onClickElement,
           children: [
-            /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(Icon_default, { name: item.iconName, color: theme2.colors.primary, size: iconSize, flexShrink: 0 }),
+            /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(
+              Icon_default,
+              {
+                name: item.iconName,
+                color: isActive && backgroundColorContrast < 7 ? theme2.colors.base : theme2.colors.primary,
+                size: iconSize,
+                flexShrink: 0
+              }
+            ),
             /* @__PURE__ */ (0, import_jsx_runtime28.jsx)(
               Text_default,
               {
                 flex: 1,
                 lineHeight: `${lineHeight}px`,
-                color: isActive ? theme2.colors.primary : theme2.colors.textPrimary,
+                color: isActive ? backgroundColorContrast < 7 ? theme2.colors.base : theme2.colors.primary : theme2.colors.textPrimary,
                 opacity: isCollapsed ? 0 : void 0,
                 transition: theme2.styles.transition,
                 children: item.text
@@ -7614,6 +7643,8 @@ var SideMenuComponent = function SideMenu({
   bottomItemsAdditionalComponent,
   isLoading,
   backgroundColor,
+  activeItemColor,
+  hoverItemColor,
   gap,
   paddingTop,
   paddingBottom,
@@ -7656,6 +7687,8 @@ var SideMenuComponent = function SideMenu({
         {
           item,
           backgroundColor: readyBackgroundColor,
+          activeItemColor,
+          hoverItemColor,
           onClick: onClickXButton
         },
         item.text
@@ -7676,6 +7709,8 @@ var SideMenuComponent = function SideMenu({
         {
           item,
           backgroundColor: readyBackgroundColor,
+          activeItemColor,
+          hoverItemColor,
           onClick: onClickXButton
         },
         item.text
@@ -7933,6 +7968,7 @@ var SideMenu_default = SideMenu2;
   Tooltip,
   alertControls,
   alertsPlugin,
+  calculateColorContrast,
   colorThemeControls,
   countries,
   darkenColor,