@spteck/react-controls-v2 2.5.14 → 2.5.16

package/dist/components/buttonMenu/ButtonMenu.d.ts

@@ -1,22 +1,48 @@
 import { Theme } from '@fluentui/react-components';
-import { IButtonMenuOption } from './IButtonMenuOption';
+import { ButtonMenuItemType, IButtonMenuOption } from './IButtonMenuOption';
 import * as React from "react";
 export interface IButtonMenuStyles {
     root?: React.CSSProperties;
     menulist?: React.CSSProperties;
     menuitem?: React.CSSProperties;
 }
+export interface IButtonMenuRenderHelpers {
+    /** True when the option is currently part of the selection. */
+    isSelected: boolean;
+    /** True when the menu is rendering this item as disabled. */
+    isDisabled: boolean;
+    /** Resolved item type after considering per-option override and `defaultItemType`. */
+    itemType: ButtonMenuItemType;
+}
 export interface IButtonMenuProps {
-    onSelected: (option: IButtonMenuOption) => void;
+    /** Single-selection / "item" mode callback. Called with the clicked option. */
+    onSelected?: (option: IButtonMenuOption) => void;
+    /** Multi-selection callback (checkbox mode). Receives the full set of selected options. */
+    onSelectionChange?: (selectedOptions: IButtonMenuOption[]) => void;
+    /** Controlled selected option for radio mode. */
     value?: IButtonMenuOption;
+    /** Controlled selected keys for checkbox mode. */
+    selectedKeys?: string[];
     label?: string;
+    /**
+     * Fixed text rendered inside the trigger button.
+     * - Required for `checkbox` mode and `divider/header`-only menus.
+     * - In `radio` and `item` modes, when omitted the button reflects the selected/last-clicked option.
+     */
     buttonText?: string;
     styles?: React.CSSProperties | IButtonMenuStyles;
     theme?: Theme;
     options: IButtonMenuOption[];
+    /** Default control to render for items that do not specify `itemType`. Defaults to `'radio'`. */
+    defaultItemType?: ButtonMenuItemType;
     apparence?: "primary" | "subtle" | "outline" | "transparent";
     shape?: "circular" | "square";
     size?: "small" | "medium" | "large";
+    /**
+     * Optional renderer for menu items. Return `defaultRender()` to fall back to
+     * the standard Fluent control for the resolved `itemType`.
+     */
+    onRenderItem?: (option: IButtonMenuOption, defaultRender: () => React.ReactNode, helpers: IButtonMenuRenderHelpers) => React.ReactNode;
 }
 export declare const ButtonMenu: React.FunctionComponent<IButtonMenuProps>;
 //# sourceMappingURL=ButtonMenu.d.ts.map

package/dist/components/buttonMenu/IButtonMenuOption.d.ts

@@ -1,10 +1,22 @@
+import * as React from "react";
+export type ButtonMenuItemType = "radio" | "checkbox" | "item" | "divider" | "header";
 export interface IButtonMenuOption {
+    /** Unique key. Required for selectable items; optional for divider/header. */
     key: string;
+    /** Display text. Used as label and as header text when itemType === 'header'. */
     text: string;
     icon?: React.ReactElement;
-    selected: boolean;
+    /** Initial selection hint (used when no `value` / `selectedKeys` is provided). */
+    selected?: boolean;
     disabled?: boolean;
     description?: string;
     color?: string;
+    /**
+     * Per-option override of the rendered control. When omitted, the component
+     * falls back to the top-level `defaultItemType` on `<ButtonMenu />`.
+     */
+    itemType?: ButtonMenuItemType;
+    /** Optional secondary text rendered to the right of the item. */
+    secondaryContent?: React.ReactNode;
 }
 //# sourceMappingURL=IButtonMenuOption.d.ts.map