@myunisoft/design-system 1.3.3-rev157 → 1.3.4-rev157-2types

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myunisoft/design-system",
-  "version": "1.3.3-rev157",
+  "version": "1.3.4-rev157-2types",
   "description": "Design System of MyUnisoft",
   "main": "dist/index.js",
   "source": "src/index.ts",

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

@@ -1,14 +0,0 @@
-import type { ReactNode, RefObject } from 'react';
-import { PopperPlacementType } from '@mui/material';
-type AnchoredPopperProps = {
-    open: boolean;
-    anchorRef: RefObject<HTMLElement | null>;
-    onClose: () => void;
-    placement?: PopperPlacementType;
-    children: ReactNode;
-    minWidth?: number | string;
-    zIndex?: number;
-    elevation?: number;
-};
-declare const AnchoredPopper: ({ open, anchorRef, onClose, placement, children, minWidth, zIndex, elevation }: AnchoredPopperProps) => import("react/jsx-runtime").JSX.Element;
-export default AnchoredPopper;

package/dist/components/Autocomplete/Autocomplete/example-usage.d.ts

@@ -1,4 +0,0 @@
-declare const BasicExample: () => import("react/jsx-runtime").JSX.Element;
-declare const CustomOptionExample: () => import("react/jsx-runtime").JSX.Element;
-declare const ProductExample: () => import("react/jsx-runtime").JSX.Element;
-export { BasicExample, CustomOptionExample, ProductExample };

package/dist/components/DataGrid/components/toolbar/buttons/AddButton.d.ts

@@ -1,6 +0,0 @@
-type AddButtonProps = {
-    onClick: () => void;
-    disabled?: boolean;
-};
-declare const AddButton: ({ onClick, disabled }: AddButtonProps) => import("react/jsx-runtime").JSX.Element;
-export default AddButton;

package/dist/components/DataGrid/components/toolbar/buttons/ExportButton.d.ts

@@ -1,9 +0,0 @@
-import { GridExportFormat } from '@mui/x-data-grid-pro';
-type ExportButtonProps = {
-    exportAction?: {
-        onExport: (format: GridExportFormat) => void;
-        exportFormats: GridExportFormat[];
-    };
-};
-declare const ExportButton: ({ exportAction }: ExportButtonProps) => import("react/jsx-runtime").JSX.Element;
-export default ExportButton;

package/dist/components/DataGrid/types/index.d.ts

@@ -1,428 +0,0 @@
-import type { ReactNode, RefObject, ComponentType, Dispatch, SetStateAction } from 'react';
-import type { ButtonProps } from '@mui/material';
-import type { DataGridProProps, GridApiPro, GridColDef as MuiGridColDef, GridRowSelectionModel, GridValidRowModel } from '@mui/x-data-grid-pro';
-/**
- * Extended GridColDef with custom export-related properties
- */
-export type GridColDef<R extends GridValidRowModel = any, V = any, F = V> = MuiGridColDef<R, V, F> & {
-    /**
-     * Custom formatter function for export operations
-     * @param params - Object containing the value and row data
-     * @returns Formatted value for export
-     */
-    exportFormatter?: (params: {
-        value: V;
-        row: R;
-    }) => any;
-    /**
-     * If true, this column will be excluded from export operations
-     */
-    ignoreExport?: boolean;
-};
-/**
- * Props for the DataGridDS component
- * Extends MUI DataGridProProps with custom row context menu functionality
- */
-export interface DataGridDSProps extends DataGridProProps {
-    /**
-     * Configuration for row context menu (right-click menu)
-     */
-    rowContextMenu?: RowContextMenuConfig;
-}
-/**
- * Configuration for row context menu
- */
-export interface RowContextMenuConfig {
-    /**
-     * Array of actions available in the context menu
-     */
-    actions: RowMenuAction[];
-    /**
-     * Optional function to determine if the menu can be opened
-     * @param selectedRows - Currently selected rows
-     * @returns true if menu can be opened, false otherwise
-     */
-    canOpen?: (selectedRows: GridValidRowModel[]) => boolean;
-}
-/**
- * Action definition for row context menu
- */
-export type RowMenuAction = {
-    /**
-     * Unique identifier for the action
-     */
-    key: string;
-    /**
-     * Display label for the action
-     */
-    label: string;
-    /**
-     * Callback function executed when action is clicked
-     * @param selectedRows - Array of selected row models
-     */
-    onClick: (selectedRows: GridValidRowModel[]) => void;
-    /**
-     * Whether the action is disabled
-     * Can be a boolean or a function that determines disabled state based on selected rows
-     */
-    disabled?: boolean | ((selectedRows: GridValidRowModel[]) => boolean);
-};
-/**
- * Props for RowMenu component
- */
-export interface RowMenuProps {
-    /**
-     * Whether the menu is currently open
-     */
-    isOpen: boolean;
-    /**
-     * Callback to close the menu
-     */
-    onClose: () => void;
-    /**
-     * X coordinate for menu positioning
-     */
-    mouseX: number;
-    /**
-     * Y coordinate for menu positioning
-     */
-    mouseY: number;
-    /**
-     * Array of actions to display in the menu
-     */
-    rowMenuActions: RowMenuAction[];
-    /**
-     * Currently selected rows
-     */
-    selectedRows: GridValidRowModel[];
-}
-/**
- * State for row menu hook
- */
-export interface RowMenuState {
-    /**
-     * Whether the menu is open
-     */
-    isOpen: boolean;
-    /**
-     * Mouse X coordinate
-     */
-    mouseX: number;
-    /**
-     * Mouse Y coordinate
-     */
-    mouseY: number;
-}
-/**
- * Return type for useRowMenu hook
- */
-export interface UseRowMenuReturn {
-    /**
-     * Current menu state
-     */
-    rowMenuState: RowMenuState;
-    /**
-     * Function to open the menu at specified coordinates
-     */
-    openRowMenu: (mouseX: number, mouseY: number) => void;
-    /**
-     * Function to close the menu
-     */
-    closeRowMenu: () => void;
-}
-/**
- * Base configuration for toolbar buttons
- */
-interface BaseButtonConfig {
-    /**
-     * Unique identifier for the button
-     */
-    key: ButtonKey;
-    /**
-     * Button color theme
-     */
-    color?: ButtonProps['color'];
-    /**
-     * Whether the button is disabled
-     */
-    disabled?: boolean;
-    /**
-     * Whether the button is in loading state
-     */
-    isLoading?: boolean;
-}
-/**
- * Configuration for text-based toolbar button
- */
-export interface TextButtonConfig extends BaseButtonConfig {
-    type: 'text';
-    /**
-     * Button text label
-     */
-    text: string;
-    /**
-     * Click handler
-     */
-    onClick: ButtonProps['onClick'];
-}
-/**
- * Configuration for icon-based toolbar button
- */
-export interface IconButtonConfig extends BaseButtonConfig {
-    type: 'icon';
-    /**
-     * Icon element to display
-     */
-    icon: ReactNode;
-    /**
-     * Click handler
-     */
-    onClick: ButtonProps['onClick'];
-}
-/**
- * Union type for all button configurations
- */
-export type ButtonConfig = TextButtonConfig | IconButtonConfig;
-/**
- * Type for button keys
- */
-export type ButtonKey = string | number;
-/**
- * Props for ArrayButtons component
- */
-export interface ArrayButtonsProps {
-    /**
-     * Array of button configurations to render
-     */
-    buttons: ButtonConfig[];
-}
-/**
- * Custom text button configuration with enhanced onClick signature
- */
-export interface CustomTextButtonConfig extends Omit<TextButtonConfig, 'onClick'> {
-    /**
-     * Enhanced onClick handler that receives selected row information
-     * @param selectedRowIds - Array of selected row IDs
-     * @param selectedRows - Array of selected row models
-     */
-    onClick: (selectedRowIds: GridRowSelectionModel, selectedRows: GridValidRowModel[]) => void | Promise<void>;
-}
-/**
- * Custom icon button configuration with enhanced onClick signature
- */
-export interface CustomIconButtonConfig extends Omit<IconButtonConfig, 'onClick'> {
-    /**
-     * Enhanced onClick handler that receives selected row information
-     * @param selectedRowIds - Array of selected row IDs
-     * @param selectedRows - Array of selected row models
-     */
-    onClick: (selectedRowIds: GridRowSelectionModel, selectedRows: GridValidRowModel[]) => void | Promise<void>;
-}
-/**
- * Union type for custom toolbar button configurations
- */
-export type CustomToolbarButtonConfig = CustomTextButtonConfig | CustomIconButtonConfig;
-/**
- * Configuration for delete action in toolbar
- */
-export interface DeleteAction {
-    /**
-     * Handler function for delete operation
-     * @param selectedRowIds - Array of selected row IDs to delete
-     * @returns Promise or boolean indicating success
-     */
-    onDelete: (selectedRowIds: GridRowSelectionModel) => boolean | Promise<boolean>;
-    /**
-     * Whether the delete action is disabled
-     */
-    disabled?: boolean;
-}
-/**
- * Configuration for bulk edit action in toolbar
- */
-export interface BulkEditAction {
-    /**
-     * Handler function for bulk edit save operation
-     * @param selectedRowIds - Array of selected row IDs
-     * @param newRows - Array of modified row models
-     * @returns Promise or boolean indicating success
-     */
-    onBulkEditSave: (selectedRowIds: GridRowSelectionModel, newRows: GridValidRowModel[]) => boolean | Promise<boolean>;
-    /**
-     * Whether the bulk edit action is disabled
-     */
-    disabled?: boolean;
-}
-/**
- * Configuration for add action in toolbar
- */
-export interface AddAction {
-    /**
-     * Handler function for add operation
-     */
-    onClick: () => void;
-    /**
-     * Whether the add action is disabled
-     */
-    disabled?: boolean;
-}
-/**
- * Configuration for content component to be displayed in AnchoredPopper
- * Note: This type matches the contentComponentConfig from AnchoredPopper
- * for use within DataGrid components
- */
-export type ContentComponentConfig = {
-    /**
-     * Name identifier for the component (useful for debugging/analytics)
-     */
-    name: string;
-    /**
-     * React component to render
-     */
-    component: ComponentType<any>;
-    /**
-     * Props to pass to the component
-     */
-    props: Record<string, any>;
-};
-/**
- * Action definition for actions menu (toolbar menu)
- */
-export type MenuAction = {
-    /**
-     * Unique identifier for the action
-     */
-    key: string;
-    /**
-     * Display label for the action
-     */
-    label: string;
-    /**
-     * Optional icon to display before the label
-     */
-    icon?: ReactNode;
-    /**
-     * Optional color for the menu item text
-     */
-    color?: string;
-    /**
-     * Whether the action is disabled
-     * Can be a boolean or a function that determines disabled state based on selected rows
-     */
-    disabled?: boolean | ((selectedRows: GridValidRowModel[]) => boolean);
-    /**
-     * Optional click handler for simple actions
-     * @param selectedRows - Array of selected row models
-     */
-    onClick?: (selectedRows: GridValidRowModel[]) => void;
-    /**
-     * Optional configuration for displaying a popper with custom content
-     * When provided, clicking the action will open an AnchoredPopper with the specified component
-     */
-    contentConfig?: ContentComponentConfig | null;
-};
-/**
- * Props for ActionsMenu component
- */
-export interface ActionsMenuProps {
-    /**
-     * Whether the menu is currently open
-     */
-    isOpen: boolean;
-    /**
-     * Anchor element for the menu
-     */
-    anchorEl: HTMLElement | null;
-    /**
-     * Array of menu actions to display
-     */
-    menuActions: MenuAction[];
-    /**
-     * Currently selected rows
-     */
-    selectedRows: GridValidRowModel[];
-    /**
-     * Callback to close the menu
-     */
-    onClose: () => void;
-    /**
-     * Reference to the element that should anchor the popper
-     */
-    popperAnchorRef: RefObject<HTMLElement | null>;
-}
-/**
- * Type for EditContext value
- */
-export interface EditContextType {
-    /**
-     * Whether bulk editing mode is active
-     */
-    isBulkEditing: boolean;
-    /**
-     * Whether an edit save operation is in progress
-     */
-    isEditSaving: boolean;
-    /**
-     * Function to set bulk editing state
-     */
-    setIsBulkEditing: Dispatch<SetStateAction<boolean>>;
-    /**
-     * Function to set edit saving state
-     */
-    setIsEditSaving: Dispatch<SetStateAction<boolean>>;
-}
-/**
- * Props for EditProvider component
- */
-export interface EditProviderProps {
-    /**
-     * Child components
-     */
-    children: ReactNode;
-}
-/**
- * Function type for exporting grid data to Excel
- */
-export type ExportGridApiToExcelFn = (apiRef: RefObject<GridApiPro>, fileName: string, sheetName?: string) => Promise<void>;
-/**
- * Function type for attaching Excel export functionality to grid API
- */
-export type AttachExcelExportToApiFn = (apiRef: RefObject<GridApiPro>, fileName?: string) => void;
-/**
- * Function type for getting selected rows from grid API
- */
-export type GetSelectedRowsFn = (apiRef: RefObject<GridApiPro>) => GridValidRowModel[];
-/**
- * Augmentation for MUI DataGridPro ToolbarPropsOverrides
- * Adds custom toolbar props to the DataGridPro component
- */
-declare module '@mui/x-data-grid-pro' {
-    interface ToolbarPropsOverrides {
-        /**
-         * Whether to show the selected row count
-         * @default true
-         */
-        showSelectedCount?: boolean;
-        /**
-         * Array of custom button configurations
-         */
-        customButtons?: CustomToolbarButtonConfig[];
-        /**
-         * Configuration for delete action
-         */
-        deleteAction?: DeleteAction;
-        /**
-         * Configuration for bulk edit action
-         */
-        bulkEditAction?: BulkEditAction;
-        /**
-         * Array of menu actions for the actions menu
-         */
-        menuActions?: MenuAction[];
-        /**
-         * Configuration for add action
-         */
-        addAction?: AddAction;
-    }
-}
-export {};

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

@@ -1,15 +0,0 @@
-import { type RefObject } from 'react';
-import type { DocumentSection } from '../types';
-type UseDragVisualFeedbackParams = {
-    containerRef: RefObject<HTMLDivElement | null>;
-    getSectionById: (sectionId: string) => DocumentSection | null;
-    isValidDropTarget?: (draggedSection: DocumentSection, targetSection: DocumentSection | null, newIndex: number) => boolean;
-};
-/**
- * Provides visual feedback during drag-and-drop by graying out invalid drop targets.
- *
- * Uses direct DOM manipulation instead of React state to avoid re-rendering
- * all tree items on every drag event.
- */
-export declare const useDragVisualFeedback: ({ containerRef, getSectionById, isValidDropTarget }: UseDragVisualFeedbackParams) => void;
-export {};

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

@@ -1,67 +0,0 @@
-import type { ReactNode } from 'react';
-import type { ItemPositionParams } from '../Treeview/types';
-import type { DocumentSection, SectionContent } from './section';
-export type DeleteConfirmationRenderProps = {
-    isOpen: boolean;
-    onConfirm: () => void;
-    onCancel: () => void;
-};
-export type UnsavedChangesRenderProps = {
-    isOpen: boolean;
-    isSaving: boolean;
-    /** True if onSectionContentSave is provided */
-    canSave: boolean;
-    onSaveAndQuit: () => void;
-    onQuitWithoutSaving: () => void;
-    onCancel: () => void;
-};
-export type DocumentComposerLabels = {
-    createSection?: string;
-    rename?: string;
-    delete?: string;
-    createSubsection?: string;
-    hiddenItemTooltip?: string;
-};
-export type DocumentComposerCustomProps = {
-    noSectionsPlaceholder?: string | ReactNode;
-    isLoadingSections?: boolean;
-    /** Defaults to `() => true` */
-    getSectionTitleChangePermission?: (section: DocumentSection) => boolean;
-    /** Defaults to `() => true` */
-    getSectionDeletePermission?: (section: DocumentSection) => boolean;
-    /** Defaults to `() => true` */
-    getSectionOrderChangePermission?: (section: DocumentSection) => boolean;
-    /**
-     * Custom validation for drag & drop positions.
-     * Called after basic permission checks pass.
-     * Use this to implement custom drop zone restrictions (e.g., only drop after certain sections).
-     * Defaults to `() => true`
-     */
-    canMoveSectionToNewPosition?: (params: ItemPositionParams) => boolean;
-    /** Defaults to `() => true` */
-    getSectionCreatePermission?: (section: DocumentSection) => boolean;
-    /** Defaults to `() => true` */
-    getSectionVisibilityChangePermission?: (section: DocumentSection) => boolean;
-    hiddenSectionTooltip?: string;
-    visibleIconTooltip?: string;
-    hiddenIconTooltip?: string;
-    /** Return null for no icon */
-    renderSectionIcon?: (section: DocumentSection) => ReactNode;
-    sectionContent?: SectionContent;
-    isLoadingSectionContent?: boolean;
-    selectedSectionId?: string | null;
-    /** If not provided, deletion proceeds without confirmation */
-    renderDeleteConfirmation?: (props: DeleteConfirmationRenderProps) => ReactNode;
-    /** If not provided, navigation proceeds without confirmation (discards changes) */
-    renderUnsavedChangesConfirmation?: (props: UnsavedChangesRenderProps) => ReactNode;
-};
-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>;
-    onSectionSelect?: (sectionId: string | null) => void;
-    /** Used by unsaved changes modal "Save and quit" action */
-    onSectionContentSave?: () => Promise<void>;
-};

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

@@ -1,33 +0,0 @@
-export declare const CellFormat: {
-    readonly TEXT: "text";
-    readonly AMOUNT: "amount";
-};
-export type CellFormat = (typeof CellFormat)[keyof typeof CellFormat];
-export type TableCell = {
-    value: string;
-    editable: boolean;
-    format: CellFormat;
-};
-export type TableRow = TableCell[];
-export type TableValue = {
-    id: string;
-    headers: TableRow[];
-    rows: TableRow[];
-    footers: TableRow[];
-};
-export type TableContentBlock = {
-    type: 'table';
-    value: TableValue;
-};
-/** Extend this union as new content block types are added */
-export type ContentBlock = TableContentBlock;
-export type SectionContent = ContentBlock[];
-export type DocumentSection = {
-    id: string;
-    title: string;
-    visible: boolean;
-    parentId: string | null;
-    type?: string;
-    hasTables?: boolean;
-    sections?: DocumentSection[] | null;
-};

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

@@ -1,56 +0,0 @@
-import type { ItemPositionParams } from './Treeview/types';
-export type DocumentSection = {
-    id: string;
-    title: string;
-    visible: boolean;
-    parentId: string | null;
-    sections?: DocumentSection[] | null;
-};
-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`. */
-    getSectionTitleChangePermission?: (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`. */
-    getSectionOrderChangePermission?: (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`. */
-    getSectionVisibilityChangePermission?: (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;
-    /**
-     * Determines if `targetSection` is a valid drop location for `draggedSection`.
-     * When provided, invalid targets are visually greyed out during drag.
-     * Defaults to () => true (all targets valid).
-     * @param targetSection - The parent section where the item would be dropped, or `null` if dropping at root level.
-     */
-    isValidDropTarget?: (draggedSection: DocumentSection, targetSection: DocumentSection | null) => boolean;
-};
-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/Export/index.d.ts

@@ -1,3 +0,0 @@
-import type { ExportContentProps } from './types';
-declare const ExportContent: ({ exportFormats, onExport, title, selectFormatLabel, exportButtonLabel }: ExportContentProps) => import("react/jsx-runtime").JSX.Element;
-export default ExportContent;

package/dist/components/Export/style/index.d.ts

@@ -1,9 +0,0 @@
-export declare const exportTitleSx: {
-    margin: string;
-    fontFamily: string;
-    fontWeight: number;
-    fontSize: string;
-    lineHeight: number;
-    borderBottom: string;
-    paddingBottom: string;
-};

package/dist/components/Export/types/index.d.ts

@@ -1,30 +0,0 @@
-import { GridExportFormat } from "@mui/x-data-grid-pro";
-/**
- * Props for ExportContent component
- */
-export interface ExportContentProps {
-    /**
-     * Available export formats
-     */
-    exportFormats: GridExportFormat[];
-    /**
-     * Handler function called when export is triggered
-     * @param format - Selected export format
-     */
-    onExport: (format: GridExportFormat) => void;
-    /**
-     * Optional title for the export dialog
-     * @default 'Export'
-     */
-    title?: string;
-    /**
-     * Optional label for format selection
-     * @default 'Select format:'
-     */
-    selectFormatLabel?: string;
-    /**
-     * Optional label for the export button
-     * @default 'Export'
-     */
-    exportButtonLabel?: string;
-}