@myunisoft/design-system 1.2.6 → 1.2.9-rev157.2

package/dist/components/DataGrid/components/toolbar/ActionsMenu/index.d.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+import type { GridValidRowModel } from '@mui/x-data-grid-pro';
+export type MenuAction = {
+    key: string;
+    label: string;
+    icon?: ReactNode;
+    color?: string;
+    disabled?: boolean | ((selectedRows: GridValidRowModel[]) => boolean);
+    onClick: (selectedRows: GridValidRowModel[]) => void;
+};
+type ActionsMenuProps = {
+    isOpen: boolean;
+    anchorEl: HTMLElement | null;
+    menuActions: MenuAction[];
+    selectedRows: GridValidRowModel[];
+    onClose: () => void;
+};
+declare const ActionsMenu: ({ isOpen, anchorEl, menuActions, selectedRows, onClose }: ActionsMenuProps) => import("react/jsx-runtime").JSX.Element;
+export default ActionsMenu;

package/dist/components/DataGrid/components/toolbar/CustomGridToolbar.d.ts

@@ -7,20 +7,23 @@
  * Source (MUI v7.x): https://github.com/mui/mui-x/blob/v7.x/packages/x-data-grid/src/components/toolbar/GridToolbar.tsx
  */
 import { type GridRowSelectionModel, type GridSlotsComponentsProps, type GridValidRowModel } from '@mui/x-data-grid-pro';
+import { type MenuAction } from './ActionsMenu';
 import { type IconButtonConfig, type TextButtonConfig } from './ArrayButtons';
 interface DeleteAction {
     onDelete: (selectedRowIds: GridRowSelectionModel) => boolean | Promise<boolean>;
     disabled?: boolean;
 }
 interface BulkEditAction {
-    onBulkEditSave: (selectedIds: GridRowSelectionModel, newRows: GridValidRowModel[]) => boolean | Promise<boolean>;
+    onBulkEditSave: (selectedRowIds: GridRowSelectionModel, newRows: GridValidRowModel[]) => boolean | Promise<boolean>;
     disabled?: boolean;
 }
 declare module '@mui/x-data-grid-pro' {
     interface ToolbarPropsOverrides {
+        showSelectedCount?: boolean;
         customButtons?: CustomToolbarButtonConfig[];
         deleteAction?: DeleteAction;
         bulkEditAction?: BulkEditAction;
+        menuActions?: MenuAction[];
     }
 }
 interface CustomTextButtonConfig extends Omit<TextButtonConfig, 'onClick'> {

package/dist/components/DocumentComposer/LoadingSkeleton.d.ts

@@ -0,0 +1,2 @@
+export declare const LeftPanelSkeleton: () => import("react/jsx-runtime").JSX.Element;
+export declare const RightPanelSkeleton: () => import("react/jsx-runtime").JSX.Element;

package/dist/components/DocumentComposer/NoSectionsPlaceholder/index.d.ts

@@ -0,0 +1,4 @@
+declare const NoSectionsPlaceholder: ({ noSectionsPlaceholder }: {
+    noSectionsPlaceholder?: React.ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;
+export default NoSectionsPlaceholder;

package/dist/components/DocumentComposer/Treeview/CustomTreeItem.d.ts

@@ -1,7 +1,8 @@
 import type { RichTreeViewProApiRef, TreeItemProps } from '@mui/x-tree-view-pro';
 import type { TreeviewProps } from './types';
-type TreeItemCallbacks<T extends Record<string, unknown>> = Pick<TreeviewProps<T>, 'isSectionItem' | 'isVisibleItem' | 'getIconItem' | 'hasItemMenu' | 'getMenuItems' | 'isItemReorderable' | 'onItemVisibilityChange'> & {
+type TreeItemCallbacks<T extends Record<string, unknown>> = Pick<TreeviewProps<T>, 'isSectionItem' | 'isVisibleItem' | 'getIconItem' | 'hasItemMenu' | 'getMenuItems' | 'isItemReorderable' | 'onItemVisibilityChange' | 'isTemporaryItem' | 'onTemporarySectionValidation' | 'onTemporarySectionCancel' | 'onItemLabelChange' | 'hiddenSectionTooltip' | 'visibleIconTooltip' | 'hiddenIconTooltip'> & {
     apiRef: RichTreeViewProApiRef;
+    onEditingChange?: (itemId: string | null) => void;
 };
 type CustomTreeItemProps<T extends Record<string, unknown>> = TreeItemProps & TreeItemCallbacks<T>;
 export declare const CustomTreeItem: <T extends Record<string, unknown>>(props: CustomTreeItemProps<T>) => import("react/jsx-runtime").JSX.Element;

package/dist/components/DocumentComposer/Treeview/hooks/useTreeItemMenu.d.ts

@@ -7,6 +7,8 @@ export declare const useTreeItemMenu: () => {
     } | null;
     handleMenuClick: (event: React.MouseEvent<HTMLElement>) => void;
     handleMenuClose: () => void;
+    scheduleMenuAction: (action: () => void) => void;
+    onMenuExited: () => void;
     createMouseMoveHandler: (isHovered: boolean, onHoverChange?: (isHovered: boolean) => void) => (e: React.MouseEvent<HTMLDivElement>) => void;
     createMouseLeaveHandler: (onHoverChange?: (isHovered: boolean) => void) => () => void;
 };

package/dist/components/DocumentComposer/Treeview/slots/LabelInputSlot.d.ts

@@ -1,6 +1,12 @@
-type LabelInputSlotProps = {
+import type { InputHTMLAttributes } from 'react';
+import type { RichTreeViewProApiRef } from '@mui/x-tree-view-pro';
+export declare const LabelInputSlot: import("react").ForwardRefExoticComponent<InputHTMLAttributes<HTMLInputElement> & {
     ownerState?: unknown;
-    [key: string]: unknown;
-};
-export declare const LabelInputSlot: import("react").ForwardRefExoticComponent<Omit<LabelInputSlotProps, "ref"> & import("react").RefAttributes<HTMLInputElement>>;
-export {};
+    itemId?: string;
+    isTemporary?: boolean;
+    onTemporarySectionValidation?: (label: string) => void;
+    onTemporarySectionCancel?: () => void;
+    onItemLabelChange?: (itemId: string, newLabel: string) => void;
+    apiRef?: RichTreeViewProApiRef;
+    onEditingEnd?: () => void;
+} & import("react").RefAttributes<HTMLInputElement>>;

package/dist/components/DocumentComposer/Treeview/slots/LabelSlot.d.ts

@@ -11,6 +11,9 @@ type LabelSlotProps = {
     menuAnchorEl?: HTMLElement | null;
     onMenuClick?: (event: React.MouseEvent<HTMLButtonElement>) => void;
     onItemVisibilityChange?: (itemId: string, visible: boolean) => void;
+    hiddenSectionTooltip?: string;
+    visibleIconTooltip?: string;
+    hiddenIconTooltip?: string;
     [key: string]: unknown;
 };
 export declare const LabelSlot: {

package/dist/components/DocumentComposer/Treeview/types.d.ts

@@ -1,4 +1,5 @@
 import type { RichTreeViewProApiRef } from '@mui/x-tree-view-pro';
+import type { TemporarySection } from '../hooks/useTemporarySection';
 export type ItemPositionParams = {
     itemId: string;
     oldPosition: {
@@ -10,27 +11,36 @@ export type ItemPositionParams = {
         index: number;
     };
 };
+export type ScheduleMenuAction = (action: () => void) => void;
 type CustomTreeviewItemProps<T> = {
-    hasItemMenu?: (item: T) => boolean;
-    getMenuItems?: (item: T, apiRef?: RichTreeViewProApiRef) => React.ReactNode[];
-    isSectionItem?: (item: T) => boolean;
-    getIconItem?: (item: T) => React.ReactNode;
-    isItemEditable?: (item: T) => boolean;
-    isVisibleItem?: (item: T) => boolean;
-    onItemVisibilityChange?: (itemId: string, visible: boolean) => void;
+    hasItemMenu: (item: T) => boolean;
+    getMenuItems: (item: T, scheduleMenuAction: ScheduleMenuAction) => React.ReactNode[];
+    isSectionItem: (item: T) => boolean;
+    getIconItem: (item: T) => React.ReactNode;
+    isItemEditable: (item: T) => boolean;
+    isVisibleItem: (item: T) => boolean;
+    onItemVisibilityChange: (itemId: string, visible: boolean) => void;
+    hiddenSectionTooltip?: string;
+    visibleIconTooltip?: string;
+    hiddenIconTooltip?: string;
 };
 export type TreeviewProps<T> = {
+    apiRef: RichTreeViewProApiRef;
     items: readonly T[];
-    getItemId?: (item: T) => string;
-    getItemLabel?: (item: T) => string;
-    getItemChildren?: (item: T) => T[] | undefined;
-    isItemReorderable?: (itemId: string) => boolean;
-    canMoveItemToNewPosition?: (params: ItemPositionParams) => boolean;
-    onItemPositionChange?: (params: ItemPositionParams) => void;
-    onItemLabelChange?: (itemId: string, newLabel: string) => void;
+    getItemId: (item: T) => string;
+    getItemLabel: (item: T) => string;
+    getItemChildren: (item: T) => T[] | undefined;
+    isItemReorderable: (itemId: string) => boolean;
+    canMoveItemToNewPosition: (params: ItemPositionParams) => boolean;
+    onItemPositionChange: (params: ItemPositionParams) => void;
+    onItemLabelChange: (itemId: string, newLabel: string) => void;
+    temporaryItem: TemporarySection | null;
+    isTemporaryItem: (itemId: string) => boolean;
+    onTemporarySectionValidation: (label: string) => void;
+    onTemporarySectionCancel: () => void;
+    defaultExpandedItems: string[];
     checkboxSelection?: boolean;
     multiSelect?: boolean;
-    defaultExpandedItems?: string[];
 } & CustomTreeviewItemProps<T>;
 export type TreeviewItemProps<T> = {
     itemId: string;

package/dist/components/DocumentComposer/hooks/useSectionsMap.d.ts

@@ -0,0 +1,5 @@
+import type { DocumentSection } from '../types';
+export declare const useSectionsMap: (sections: DocumentSection[] | undefined) => {
+    sectionsMap: Map<string, DocumentSection>;
+    getSectionById: (sectionId: string) => DocumentSection | null;
+};

package/dist/components/DocumentComposer/hooks/useTemporarySection.d.ts

@@ -0,0 +1,25 @@
+import type { RichTreeViewProApiRef } from '@mui/x-tree-view-pro';
+import type { DocumentSection } from '../types';
+export type TemporarySection = Pick<DocumentSection, 'id' | 'parentId'> & {
+    parentVisible: boolean;
+};
+type UseTemporarySectionParams = {
+    apiRef: RichTreeViewProApiRef;
+    getSectionById: (sectionId: string) => DocumentSection | null;
+    onSubsectionCreate?: (parentId: string | null, title: string) => string | Promise<string>;
+};
+/**
+ * Flow:
+ * 1. User triggers `create(parentId)` from context menu
+ * 2. A temporary section appears in the tree in edit mode
+ * 3. User types a title and presses Enter → `validate()` is called
+ * 4. User presses Escape or leaves empty → `cancel()` is called
+ */
+export declare const useTemporarySection: ({ apiRef, getSectionById, onSubsectionCreate }: UseTemporarySectionParams) => {
+    temporarySection: TemporarySection | null;
+    create: (parentId: string) => void;
+    validate: (title: string) => Promise<void>;
+    cancel: () => void;
+    isTemporary: (sectionId: string) => boolean;
+};
+export {};

package/dist/components/DocumentComposer/index.d.ts

@@ -1,6 +1,6 @@
-import type { DocumentComposerCallbacks, DocumentComposerCustomProps, DocumentComposerSummaryItem } from './types';
+import type { DocumentComposerCallbacks, DocumentComposerCustomProps, DocumentSection } from './types';
 type DocumentComposerProps = {
-    summary?: DocumentComposerSummaryItem[];
+    sections?: DocumentSection[];
 } & DocumentComposerCallbacks & DocumentComposerCustomProps;
-declare const DocumentComposer: ({ summary, onSummaryItemOrderChange, onSummaryItemLabelChange, onSummaryItemDelete, onSummaryItemVisibilityChange, emptySummaryLabel, isLoading }: DocumentComposerProps) => import("react/jsx-runtime").JSX.Element;
+declare const DocumentComposer: ({ sections, onSectionOrderChange, onSectionTitleChange, onSectionDelete, onSectionVisibilityChange, onSubsectionCreate, noSectionsPlaceholder, isLoading, getSectionRenamePermission, getSectionDeletePermission, getSectionReorderPermission, getSubsectionCreatePermission, getSectionVisibilityPermission, hiddenSectionTooltip, visibleIconTooltip, hiddenIconTooltip }: DocumentComposerProps) => import("react/jsx-runtime").JSX.Element;
 export default DocumentComposer;

package/dist/components/DocumentComposer/types.d.ts

@@ -1,23 +1,41 @@
 import type { ItemPositionParams } from './Treeview/types';
-export type DocumentComposerSummaryItem = {
+export type DocumentSection = {
     id: string;
     title: string;
     visible: boolean;
     parentId: string | null;
-    sections?: DocumentComposerSummaryItem[] | null;
+    sections?: DocumentSection[] | null;
 };
 export type ItemDisplayOrder = {
     id: string;
     displayOrder: number;
 };
 export type DocumentComposerCustomProps = {
-    emptySummaryLabel?: string | React.ReactNode;
-    /** Show a loading state that blocks the summary */
+    /** Content displayed when there are no sections */
+    noSectionsPlaceholder?: string | React.ReactNode;
+    /** Show a loading state that prevents rendering the sections */
     isLoading?: boolean;
+    /** Returns whether section title can be edited (double-click + "Renommer" menu). Defaults to `() => true`. */
+    getSectionRenamePermission?: (section: DocumentSection) => boolean;
+    /** Returns whether section can be deleted ("Supprimer" menu). Defaults to `() => true`. */
+    getSectionDeletePermission?: (section: DocumentSection) => boolean;
+    /** Returns whether section can be reordered via drag & drop. Defaults to `() => true`. */
+    getSectionReorderPermission?: (section: DocumentSection) => boolean;
+    /** Returns whether a subsection can be created under this section. Defaults to `() => true`. */
+    getSubsectionCreatePermission?: (section: DocumentSection) => boolean;
+    /** Returns whether section visibility can be toggled. Defaults to `() => true`. */
+    getSectionVisibilityPermission?: (section: DocumentSection) => boolean;
+    /** Tooltip text displayed when hovering a hidden section label (visible: false) */
+    hiddenSectionTooltip?: string;
+    /** Tooltip text displayed when hovering the visibility icon of a visible section */
+    visibleIconTooltip?: string;
+    /** Tooltip text displayed when hovering the visibility icon of a hidden section */
+    hiddenIconTooltip?: string;
 };
 export type DocumentComposerCallbacks = {
-    onSummaryItemOrderChange?: (params: ItemPositionParams) => void;
-    onSummaryItemLabelChange?: (itemId: string, newLabel: string) => void;
-    onSummaryItemDelete?: (itemId: string) => void;
-    onSummaryItemVisibilityChange?: (itemId: string, visible: boolean) => void;
+    onSectionOrderChange?: (params: ItemPositionParams) => void;
+    onSectionTitleChange?: (sectionId: string, newTitle: string) => void;
+    onSectionDelete?: (sectionId: string) => void;
+    onSectionVisibilityChange?: (sectionId: string, visible: boolean) => void;
+    onSubsectionCreate?: (parentId: string | null, title: string) => string | Promise<string>;
 };

package/dist/components/DocumentComposer/utils/getSectionMenuItems.d.ts

@@ -0,0 +1,14 @@
+import type { ScheduleMenuAction } from '../Treeview/types';
+import type { DocumentSection } from '../types';
+type MenuItemCallbacks = {
+    onRename: (sectionId: string) => void;
+    onDelete: (sectionId: string) => void;
+    onCreateSubsection: (parentId: string) => void;
+};
+type SectionMenuCapabilities = {
+    canRename: boolean;
+    canDelete: boolean;
+    canCreateSubsection: boolean;
+};
+export declare const getSectionMenuItems: (section: DocumentSection, callbacks: MenuItemCallbacks, scheduleMenuAction: ScheduleMenuAction, capabilities: SectionMenuCapabilities) => React.ReactNode[];
+export {};

package/dist/components/DocumentComposer/utils/sectionHelpers.d.ts

@@ -0,0 +1,10 @@
+import type { DocumentSection } from '../types';
+export declare const getAllExpandableSectionIds: (sections: DocumentSection[]) => string[];
+export declare const getAllSectionsFlat: (sections: DocumentSection[]) => DocumentSection[];
+export declare const isRootSection: (section: DocumentSection) => boolean;
+export declare const hasSectionMenu: (_section: DocumentSection) => boolean;
+export declare const isSectionVisible: (section: DocumentSection) => boolean;
+export declare const getSectionChildren: (section: DocumentSection) => DocumentSection[] | undefined;
+export declare const getSectionId: (section: DocumentSection) => string;
+export declare const getSectionTitle: (section: DocumentSection) => string;
+export declare const getSectionIcon: (section: DocumentSection) => import("react/jsx-runtime").JSX.Element | null;

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export { default as BackgroundLoader } from './components/BackgroundLoader';
 export { default as BadgeAdd } from './components/BadgeAdd';
 export { default as Checkbox } from './components/basics/Checkbox';
 export { default as ExpandButton } from './components/basics/ExpandButton';
+export { default as DocumentComposer } from './components/DocumentComposer';
 export * from './components/basics/Icon/';
 export * from './components/basics/Icon/Icons-material';
 export { default as Snackbar } from './components/basics/Snackbar';