@campxdev/react-blueprint 2.1.9 → 2.1.11

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
-import { ReactNode, MouseEvent, FC, ReactElement } from 'react';
+import react__default, { ReactNode, MouseEvent, FC, ReactElement } from 'react';
 import * as _mui_material from '@mui/material';
 import { SxProps, AccordionProps as AccordionProps$1, AvatarProps, TypographyOwnProps, TypographyProps as TypographyProps$1, AlertProps as AlertProps$1, SnackbarProps as SnackbarProps$1, TooltipProps as TooltipProps$1, ButtonProps as ButtonProps$1, StackProps, TextFieldProps as TextFieldProps$1, RadioGroupProps as RadioGroupProps$1, FormControlLabelProps, CheckboxProps as CheckboxProps$1, AutocompleteProps, SwitchProps as SwitchProps$1, BoxProps, MenuProps, MenuListProps, BreadcrumbsProps as BreadcrumbsProps$1, DialogProps as DialogProps$1, IconButtonProps, MenuItemProps, TabProps, TabsProps } from '@mui/material';
 import { LayoutType } from 'recharts/types/util/types';
@@ -908,6 +908,146 @@ type TimePickerProps<TDate extends PickerValidDate, TEnableAccessibleFieldDOMStr
 } & TimePickerProps$1<TEnableAccessibleFieldDOMStructure>;
 declare const TimePicker: <TDate extends PickerValidDate, TEnableAccessibleFieldDOMStructure extends boolean = false>({ label, name, value, format, views, helperText, placeholder, required, containerProps, ...rest }: TimePickerProps<TDate, TEnableAccessibleFieldDOMStructure>) => react_jsx_runtime.JSX.Element;
 
+interface SideMenuItemProps$1 {
+    name: string;
+    path: string;
+    icon: ReactElement;
+    permissionKey?: string;
+    subMenu?: SubMenuData[];
+    menu?: SideMenuItemProps$1[];
+}
+interface SubMenuData {
+    name: string;
+    path: string;
+    permissionKey?: string;
+}
+
+interface HelpDocsAction {
+    name: string;
+    onClick: () => void;
+    backgroundColor?: string;
+}
+interface HelpDocsConfig {
+    [path: string]: {
+        actions: HelpDocsAction[];
+    };
+}
+interface AppLayoutProps {
+    /** Main content to be rendered */
+    children: ReactNode;
+    /** Navigation menu items */
+    menu: SideMenuItemProps$1[];
+    /** AppBar customization - Primary approach */
+    rightSection?: ReactNode;
+    /** Layout customization */
+    sidebarWidth?: number;
+    mainContainerSx?: any;
+    /** Help documentation configuration for route-based contextual help */
+    helpDocsConfig?: HelpDocsConfig;
+}
+
+declare const AppLayout: react__default.FC<AppLayoutProps>;
+
+interface FloatingHelpDocsProps {
+    /** Array of help actions to display */
+    actions: HelpDocsAction[];
+}
+/**
+ * FloatingHelpDocs - Route-aware floating help documentation component
+ *
+ * This component renders a floating Speed Dial with contextual help actions
+ * based on the current route configuration.
+ *
+ * @example
+ * // Renders when actions are provided for current route
+ * <FloatingHelpDocs
+ *   actions={[
+ *     { name: 'Know how to collect fee', onClick: () => window.open('...') }
+ *   ]}
+ * />
+ */
+declare const FloatingHelpDocs: react__default.FC<FloatingHelpDocsProps>;
+
+interface HelpItem {
+    key: string;
+    icon: react__default.ReactNode;
+    title: string;
+    description: string;
+    onClick: () => void;
+}
+interface HelpPopupProps {
+    /** Custom help menu items */
+    helpItems?: HelpItem[];
+    /** Custom icon for the trigger button */
+    icon?: react__default.ReactNode;
+    /** Custom styles for the trigger button */
+    triggerSx?: any;
+}
+/**
+ * Reusable Help popup component for AppLayout right section
+ *
+ * @example
+ * // In AppLayout rightSection
+ * <HelpPopup />
+ *
+ * // With custom help items
+ * <HelpPopup helpItems={customHelpItems} />
+ */
+declare const HelpPopup: react__default.FC<HelpPopupProps>;
+
+interface SwitchInstitutionPopupProps {
+    /** Institution data for switching */
+    institutionsData?: any[];
+    /** Custom text for the menu item */
+    menuText?: string;
+}
+/**
+ * Reusable SwitchInstitution popup component that renders as a dropdown menu item
+ * Designed to be used within profile actions
+ *
+ * @example
+ * // In UserProfilePopup profileActions
+ * <SwitchInstitutionPopup institutionsData={institutions} />
+ */
+declare const SwitchInstitutionPopup: react__default.FC<SwitchInstitutionPopupProps>;
+
+interface UserProfilePopupProps {
+    /** User's full name */
+    userFullName: string;
+    /** User's designation/role */
+    designation?: string;
+    /** Profile dropdown actions (including SwitchInstitution if needed) */
+    profileActions?: react__default.ReactNode[];
+    /** Custom styles for the profile component */
+    profileSx?: any;
+    /** Whether to show active devices option */
+    showActiveDevices?: boolean;
+    /** Logout click handler */
+    onLogout?: () => void;
+    /** Profile image URL */
+    profileUrl?: string;
+    /** Whether to show avatar */
+    showAvatar?: boolean;
+    /** Whether to show navigation icon */
+    showNavigationIcon?: boolean;
+    /** Change password component */
+    changePassword?: react__default.ReactNode;
+}
+/**
+ * Reusable User Profile popup component for AppLayout right section
+ * Institution switching should be passed as a profile action if needed
+ *
+ * @example
+ * // In AppLayout rightSection
+ * <UserProfilePopup
+ *   userFullName="John Doe"
+ *   designation="Administrator"
+ *   profileActions={[<SwitchInstitutionPopup />, <MenuItem>Settings</MenuItem>]}
+ *   onLogout={handleLogout}
+ * />
+ */
+declare const UserProfilePopup: react__default.FC<UserProfilePopupProps>;
+
 type AppHeaderProps = {
     actions?: ReactNode[];
     profileActions?: ReactNode[];
@@ -929,6 +1069,25 @@ type AppHeaderProps = {
 };
 declare const AppHeader: ({ actions, profileActions, profileSx, clientLogoUrl, onLogoutClick, designation, clientName, userFullName, collapsed, institutionsData, showActiveDevices, headerSx, onAccountClick, onActiveDevicesClick, onChangeInstitutionClick, onAvatarClick, }: AppHeaderProps) => react_jsx_runtime.JSX.Element;
 
+declare const Sidebar: ({ menu, collapsed, setCollapsed, }: {
+    menu: SideMenuItemProps[];
+    collapsed: boolean;
+    setCollapsed: any;
+}) => react_jsx_runtime.JSX.Element;
+interface SideMenuItemProps {
+    name: string;
+    path: string;
+    icon: ReactElement;
+    permissionKey?: string;
+    subMenu?: SubMenuItemProps[];
+    menu?: SideMenuItemProps[];
+}
+interface SubMenuItemProps {
+    name: string;
+    path: string;
+    permissionKey?: string;
+}
+
 type AppHeaderV2Props = {
     /** Custom action components to display in the header */
     actions?: ReactNode[];
@@ -954,7 +1113,7 @@ type AppHeaderV2Props = {
     showActiveDevices?: boolean;
     /** Custom styles for the header */
     headerSx?: SxProps;
-    menu: SideMenuItemProps$1[];
+    menu: SideMenuItemProps[];
 };
 declare const AppHeaderV2: ({ actions, profileActions, profileSx, onLogoutClick, designation, userFullName, collapsed, onToggleSidebar, breadcrumbs, institutionsData, showActiveDevices, headerSx, menu, }: AppHeaderV2Props) => react_jsx_runtime.JSX.Element;
 
@@ -1122,44 +1281,6 @@ type PreviewFilesProps = {
 } & Omit<BoxProps, 'onChange'>;
 declare const PreviewFiles: ({ files, label, onChange, showDownload, hideDelete, sx, ...props }: PreviewFilesProps) => react_jsx_runtime.JSX.Element;
 
-declare const Sidebar: ({ menu, collapsed, setCollapsed, }: {
-    menu: SideMenuItemProps$1[];
-    collapsed: boolean;
-    setCollapsed: any;
-}) => react_jsx_runtime.JSX.Element;
-interface SideMenuItemProps$1 {
-    name: string;
-    path: string;
-    icon: ReactElement;
-    permissionKey?: string;
-    subMenu?: SubMenuItemProps$1[];
-    menu?: SideMenuItemProps$1[];
-}
-interface SubMenuItemProps$1 {
-    name: string;
-    path: string;
-    permissionKey?: string;
-}
-
-declare const SidebarV2: ({ menu, collapsed, setCollapsed, }: {
-    menu: SideMenuItemProps[];
-    collapsed: boolean;
-    setCollapsed: any;
-}) => react_jsx_runtime.JSX.Element;
-interface SideMenuItemProps {
-    name: string;
-    path: string;
-    icon: ReactElement;
-    permissionKey?: string;
-    subMenu?: SubMenuItemProps[];
-    menu?: SideMenuItemProps[];
-}
-interface SubMenuItemProps {
-    name: string;
-    path: string;
-    permissionKey?: string;
-}
-
 interface StepperProps {
     orientation: 'vertical' | 'horizontal';
     activeStep: number;
@@ -1259,5 +1380,5 @@ declare const splitBreadcrumbIdSlug: (param: string) => {
 declare const isLocal: boolean;
 declare const isDevelopment: boolean;
 
-export { Accordion, AccordionGroup, ActivityLogView, Alert, AnimatedGIFs, AppHeader, AppHeaderV2, BarChart, Breadcrumbs, Button, Card, CellContainer, CenterBox, Chips, CircularAvatar, ComingSoon, ConfirmDialog, DataTable, DatePicker, DateTimePicker, DensitySelector, Dialog, DialogButton, DropDownButton, DropDownIcon, DropdownMenu, DropdownMenuItem, EditableDataTable, EditableTableCore, EmptyIllustration, FileUpload, FloatingContent, FooterContainerContainer, FormActions, FormControlWrapper, FormWrapper, IconButtons, Icons, InternalServerError, LabelWrapper, LineChart, MuiThemeProvider, MultiCheckBox, NoInterneConnection, NoItemFound, OtpInput, PageContent, PageHeader, PageNotFound, PasswordField, PieChart, PreviewFiles, ProgressCard, RadioGroup, ResourceNotFound, SearchBar, Select, SidePanel, SidePanelVariables, Sidebar, SidebarV2, SingleCheckBox, SingleSelect, Snackbar, Spinner, SquareAvatar, StatusCard, Stepper, StyledContainer, Svgs, Switch, TableColumnsSelector, TableColumnsSelectorMenuFooter, TabsContainer, TabsLayout, TextField, TimePicker, Timeline, ToolTipContent, Tooltip, Tutorial, Typography, UnAuthorized, UploadDialog, createBreadcrumbIdSlug, darkTheme, getBreadcrumbsCharacter, isDevelopment, isLocal, lightTheme, reactBlueprintReducers, splitBreadcrumbIdSlug, usePageHeader, useParams, useUrlParams };
-export type { AccordionProps, Activity, ActivityAction, AlertProps, AppHeaderProps, AppHeaderV2Props, BarChartProps, BreadcrumbsProps, ButtonConfig, ButtonProps, CardProps, CheckboxProps, CircularAvatarProps, ConfirmDialogProps, ConfirmDialogType, DataTableProps, DensitySelectorProps, DialogButtonProps, DialogProps, DropdownMenuItemProps, DropdownMenuProps, EditableDataTableProps, FileUploadProps, FloatingContainerProps, FormActionsProps, IconComponent, IconProps, IconsType, LineChartProps, MultiCheckboxProps, OtpInputProps, PageContentProps, PasswordFieldProps, PieChartProps, PreviewFilesProps, ProgressCardProps, RadioGroupProps, SearchBarProps, SelectProps, Severity, SideMenuItemProps$1 as SideMenuItemProps, SidePanelProps, SingleSelectProps, SnackbarProps, SquareAvatarProps, StatusCardProps, SubMenuItemProps$1 as SubMenuItemProps, SwitchProps, TableColumnsSelectorProps, TabsContainerProps, TextFieldProps, TimelineItems, TimelineProps, TooltipContentProps, TooltipProps, TypographyProps, UploadDialogProps };
+export { Accordion, AccordionGroup, ActivityLogView, Alert, AnimatedGIFs, AppHeader, AppHeaderV2, AppLayout, BarChart, Breadcrumbs, Button, Card, CellContainer, CenterBox, Chips, CircularAvatar, ComingSoon, ConfirmDialog, DataTable, DatePicker, DateTimePicker, DensitySelector, Dialog, DialogButton, DropDownButton, DropDownIcon, DropdownMenu, DropdownMenuItem, EditableDataTable, EditableTableCore, EmptyIllustration, FileUpload, FloatingContent, FloatingHelpDocs, FooterContainerContainer, FormActions, FormControlWrapper, FormWrapper, HelpPopup, IconButtons, Icons, InternalServerError, LabelWrapper, LineChart, MuiThemeProvider, MultiCheckBox, NoInterneConnection, NoItemFound, OtpInput, PageContent, PageHeader, PageNotFound, PasswordField, PieChart, PreviewFiles, ProgressCard, RadioGroup, ResourceNotFound, SearchBar, Select, SidePanel, SidePanelVariables, Sidebar, SingleCheckBox, SingleSelect, Snackbar, Spinner, SquareAvatar, StatusCard, Stepper, StyledContainer, Svgs, Switch, SwitchInstitutionPopup, TableColumnsSelector, TableColumnsSelectorMenuFooter, TabsContainer, TabsLayout, TextField, TimePicker, Timeline, ToolTipContent, Tooltip, Tutorial, Typography, UnAuthorized, UploadDialog, UserProfilePopup, createBreadcrumbIdSlug, darkTheme, getBreadcrumbsCharacter, isDevelopment, isLocal, lightTheme, reactBlueprintReducers, splitBreadcrumbIdSlug, usePageHeader, useParams, useUrlParams };
+export type { AccordionProps, Activity, ActivityAction, AlertProps, AppHeaderProps, AppHeaderV2Props, AppLayoutProps, BarChartProps, BreadcrumbsProps, ButtonConfig, ButtonProps, CardProps, CheckboxProps, CircularAvatarProps, ConfirmDialogProps, ConfirmDialogType, DataTableProps, DensitySelectorProps, DialogButtonProps, DialogProps, DropdownMenuItemProps, DropdownMenuProps, EditableDataTableProps, FileUploadProps, FloatingContainerProps, FormActionsProps, HelpDocsAction, HelpDocsConfig, IconComponent, IconProps, IconsType, LineChartProps, MultiCheckboxProps, OtpInputProps, PageContentProps, PasswordFieldProps, PieChartProps, PreviewFilesProps, ProgressCardProps, RadioGroupProps, SearchBarProps, SelectProps, Severity, SideMenuItemProps, SidePanelProps, SingleSelectProps, SnackbarProps, SquareAvatarProps, StatusCardProps, SubMenuItemProps, SwitchProps, TableColumnsSelectorProps, TabsContainerProps, TextFieldProps, TimelineItems, TimelineProps, TooltipContentProps, TooltipProps, TypographyProps, UploadDialogProps };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@campxdev/react-blueprint",
-  "version": "2.1.9",
+  "version": "2.1.11",
   "description": "React UI component library for CampX applications",
   "author": "CampX",
   "license": "MIT",

package/dist/cjs/types/src/stories/Navigation/FloatingSidebar.stories.d.ts

@@ -1,7 +0,0 @@
-import { Meta, StoryObj } from '@storybook/react';
-import { Sidebar } from '../../components/export';
-declare const meta: Meta<typeof Sidebar>;
-export default meta;
-type Story = StoryObj<typeof Sidebar>;
-export declare const Primary: Story;
-export declare const Collapsed: Story;

package/dist/esm/types/src/stories/Navigation/FloatingSidebar.stories.d.ts

@@ -1,7 +0,0 @@
-import { Meta, StoryObj } from '@storybook/react';
-import { Sidebar } from '../../components/export';
-declare const meta: Meta<typeof Sidebar>;
-export default meta;
-type Story = StoryObj<typeof Sidebar>;
-export declare const Primary: Story;
-export declare const Collapsed: Story;