@myunisoft/design-system 1.2.9-SC-713.1 → 1.2.9-rev157-2

package/dist/assets/I18n/locales/en.d.ts

@@ -36,6 +36,9 @@ declare const _default: {
         addColumn: string;
         restoreInitial: string;
     };
+    documentComposer: {
+        createSection: string;
+    };
     dashboard: {
         ba: {
             linkTo: string;

package/dist/assets/I18n/locales/fr.d.ts

@@ -36,6 +36,9 @@ declare const _default: {
         addColumn: string;
         restoreInitial: string;
     };
+    documentComposer: {
+        createSection: string;
+    };
     dashboard: {
         ba: {
             linkTo: string;

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

@@ -0,0 +1,9 @@
+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' | '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;
+export {};

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

@@ -0,0 +1,14 @@
+export declare const useTreeItemMenu: () => {
+    containerRef: import("react").RefObject<HTMLDivElement | null>;
+    menuAnchorEl: HTMLElement | null;
+    menuPosition: {
+        top: number;
+        left: number;
+    } | 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/index.d.ts

@@ -0,0 +1,3 @@
+import type { TreeviewProps } from './types';
+declare const Treeview: <T extends Record<string, unknown>>(props: TreeviewProps<T>) => import("react/jsx-runtime").JSX.Element;
+export default Treeview;

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

@@ -0,0 +1,14 @@
+import type { SxProps, Theme } from '@mui/material';
+type IconContainerSlotProps = {
+    ownerState?: unknown;
+    children?: React.ReactNode;
+    sx?: SxProps<Theme>;
+    isDraggable?: boolean;
+    isVisible?: boolean;
+    [key: string]: unknown;
+};
+export declare const IconContainerSlot: {
+    (props: IconContainerSlotProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export {};

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

@@ -0,0 +1,12 @@
+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;
+    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

@@ -0,0 +1,23 @@
+import type { SxProps, Theme } from '@mui/material';
+type LabelSlotProps = {
+    ownerState?: unknown;
+    editable?: unknown;
+    children?: React.ReactNode;
+    sx?: SxProps<Theme>;
+    customIcon?: React.ReactNode;
+    hasMenu?: boolean;
+    isVisible?: boolean;
+    itemId: string;
+    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: {
+    (props: LabelSlotProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export {};

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

@@ -0,0 +1,3 @@
+export { IconContainerSlot } from './IconContainerSlot';
+export { LabelInputSlot } from './LabelInputSlot';
+export { LabelSlot } from './LabelSlot';

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

@@ -0,0 +1,50 @@
+import type { RichTreeViewProApiRef } from '@mui/x-tree-view-pro';
+import type { TemporarySection } from '../hooks/useTemporarySection';
+export type ItemPositionParams = {
+    itemId: string;
+    oldPosition: {
+        parentId: string | null;
+        index: number;
+    };
+    newPosition: {
+        parentId: string | null;
+        index: number;
+    };
+};
+export type ScheduleMenuAction = (action: () => void) => void;
+type CustomTreeviewItemProps<T> = {
+    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;
+    temporaryItem: TemporarySection | null;
+    isTemporaryItem: (itemId: string) => boolean;
+    onTemporarySectionValidation: (label: string) => void;
+    onTemporarySectionCancel: () => void;
+    defaultExpandedItems: string[];
+    checkboxSelection?: boolean;
+    multiSelect?: boolean;
+} & CustomTreeviewItemProps<T>;
+export type TreeviewItemProps<T> = {
+    itemId: string;
+    label?: React.ReactNode;
+    children?: React.ReactNode;
+} & CustomTreeviewItemProps<T>;
+export {};

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,26 @@
+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;
+    onSectionCreate?: (parentId: string | null, title: string) => string | Promise<string>;
+    scrollToBottom?: () => void;
+};
+/**
+ * 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, onSectionCreate, scrollToBottom }: UseTemporarySectionParams) => {
+    temporarySection: TemporarySection | null;
+    create: (parentId?: string | null) => void;
+    validate: (title: string) => Promise<void>;
+    cancel: () => void;
+    isTemporary: (sectionId: string) => boolean;
+};
+export {};

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

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

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

@@ -0,0 +1,53 @@
+import type { ItemPositionParams } from './Treeview/types';
+export type DocumentSection = {
+    id: string;
+    title: string;
+    visible: boolean;
+    parentId: string | null;
+    sections?: DocumentSection[] | null;
+};
+export type ItemDisplayOrder = {
+    id: string;
+    displayOrder: number;
+};
+export type DocumentComposerLabels = {
+    /** Label for the "Create section" button */
+    createSection?: string;
+    /** Label for the "Rename" menu item */
+    rename?: string;
+    /** Label for the "Delete" menu item */
+    delete?: string;
+    /** Label for the "Create subsection" menu item */
+    createSubsection?: string;
+    /** Tooltip for hidden item */
+    hiddenItemTooltip?: string;
+};
+export type DocumentComposerCustomProps = {
+    /** 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 section can be created under this section. Defaults to `() => true`. */
+    getSectionCreatePermission?: (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 = {
+    onSectionOrderChange?: (params: ItemPositionParams) => void;
+    onSectionTitleChange?: (sectionId: string, newTitle: string) => void;
+    onSectionDelete?: (sectionId: string) => void;
+    onSectionVisibilityChange?: (sectionId: string, visible: boolean) => void;
+    onSectionCreate?: (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';