@etsoo/materialui 1.4.68 → 1.4.70

package/lib/mjs/index.js

@@ -0,0 +1,118 @@
+export * from "./app/CommonApp";
+export * from "./app/IServiceApp";
+export * from "./app/IServiceAppSettings";
+export * from "./app/IServicePage";
+export * from "./app/IServiceUser";
+export * from "./app/ISmartERPUser";
+export * from "./app/Labels";
+export * from "./app/ReactApp";
+export * from "./app/ServiceApp";
+export * from "./custom/CustomFieldUtils";
+export * from "./custom/CustomFieldViewer";
+export * from "./custom/CustomFieldWindow";
+export * from "./messages/MessageUtils";
+export * from "./messages/OperationMessageContainer";
+export * from "./messages/OperationMessageDto";
+export * from "./messages/OperationMessageHandler";
+export * from "./messages/RefreshHandler";
+export * from "./messages/SignalRUser";
+export * from "./pages/CommonPage";
+export * from "./pages/DataGridPage";
+export * from "./pages/DataGridPageProps";
+export * from "./pages/DrawerHeader";
+export * from "./pages/EditPage";
+export * from "./pages/FixedListPage";
+export * from "./pages/LeftDrawer";
+export * from "./pages/ListPage";
+export * from "./pages/ResponsivePage";
+export * from "./pages/SearchPageProps";
+export * from "./pages/TablePage";
+export * from "./pages/UserMenu";
+export * from "./pages/ViewPage";
+export * from "./texts/DateText";
+export * from "./texts/MoneyText";
+export * from "./texts/NumberText";
+export * from "./AddresSelector";
+export * from "./AuditDisplay";
+export * from "./AutocompleteExtendedProps";
+export * from "./BackButton";
+export * from "./BridgeCloseButton";
+export * from "./ButtonLink";
+export * from "./ButtonPopover";
+export * from "./ComboBox";
+export * from "./ComboBoxMultiple";
+export * from "./ComboBoxPro";
+export * from "./CountdownButton";
+export * from "./CountryList";
+export * from "./CultureDataTable";
+export * from "./CustomFabProps";
+export * from "./DataGridEx";
+export * from "./DataGridRenderers";
+export * from "./DataSteps";
+export * from "./DataTable";
+export * from "./DialogButton";
+export * from "./DnDList";
+export * from "./DraggablePaperComponent";
+export * from "./EmailInput";
+export * from "./FabBox";
+export * from "./FieldSetEx";
+export * from "./FileUploadButton";
+export * from "./FlexBox";
+export * from "./GridDataFormat";
+export * from "./GridUtils";
+export * from "./HiSelector";
+export * from "./HiSelectorTL";
+export * from "./IconButtonLink";
+export * from "./InputField";
+export * from "./InputTipField";
+export * from "./IntInputField";
+export * from "./ItemList";
+export * from "./LineChart";
+export * from "./ListChooser";
+export * from "./ListItemRightIcon";
+export * from "./ListMoreDisplay";
+export * from "./LoadingButton";
+export * from "./MaskInput";
+export * from "./MenuButton";
+export * from "./MobileListItemRenderer";
+export * from "./MoneyInputField";
+export * from "./MoreFab";
+export * from "./MUGlobal";
+export * from "./MUUtils";
+export * from "./NotifierMU";
+export * from "./NotifierPopupProps";
+export * from "./NumberInputField";
+export * from "./OptionBool";
+export * from "./OptionGroup";
+export * from "./OptionGroupFlag";
+export * from "./PercentCircularProgress";
+export * from "./PercentLinearProgress";
+export * from "./PList";
+export * from "./ProgressCount";
+export * from "./PullToRefreshUI";
+export * from "./QuickList";
+export * from "./RegionsRQ";
+export * from "./ResponsibleContainer";
+export * from "./ResponsiveStyleValue";
+export * from "./ScrollerListEx";
+export * from "./ScrollTopFab";
+export * from "./SearchBar";
+export * from "./SearchField";
+export * from "./SearchOptionGroup";
+export * from "./SelectBool";
+export * from "./SelectEx";
+export * from "./ShowDataComparison";
+export * from "./Switch";
+export * from "./SwitchAnt";
+export * from "./SwitchField";
+export * from "./TabBox";
+export * from "./TableEx";
+export * from "./TextFieldEx";
+export * from "./Tiplist";
+export * from "./TiplistPro";
+export * from "./TagList";
+export * from "./TagListPro";
+export * from "./TwoFieldInput";
+export * from "./TooltipClick";
+export * from "./UserAvatar";
+export * from "./UserAvatarEditor";

package/lib/mjs/messages/MessageUtils.d.ts

@@ -0,0 +1,52 @@
+import { SignalRUser } from "./SignalRUser";
+import { OperationMessageDto } from "./OperationMessageDto";
+import { OperationMessageHandler } from "./OperationMessageHandler";
+import EventEmitter from "eventemitter3";
+/**
+ * Message utilities
+ * 消息工具
+ */
+export declare namespace MessageUtils {
+    /**
+     * Event emitter
+     */
+    const eventEmitter: EventEmitter<string | symbol, any>;
+    /**
+     * Emit operation message
+     * 发出操作信息
+     * @param seed Refresh seed
+     */
+    function emitOperationMessage(user: SignalRUser | undefined, isSelf: boolean, message: OperationMessageDto): void;
+    /**
+     * Emit refresh
+     * 发出刷新
+     * @param user SignalR user
+     * @param isSelf Is current user self
+     * @param message Message
+     */
+    function emitRefresh(): void;
+    /**
+     * Add operation event listener
+     * 添加操作事件监控器
+     * @param handler Handler
+     */
+    function onOperationMessage(handler: OperationMessageHandler): void;
+    /**
+     * Add refresh event listener
+     * 添加事件事件监控器
+     * @param handler Handler
+     */
+    function onRefresh(handler: OperationMessageHandler): void;
+    /**
+     * Remove operation event listener
+     * 移除操作事件监控器
+     * @param handler Handler
+     */
+    function offOperationMessage(handler: OperationMessageHandler): void;
+    /**
+     * Remove refresh event listener
+     * 移除刷新事件监控器
+     * @param handler Handler
+     */
+    function offRefresh(handler: OperationMessageHandler): void;
+}

package/lib/mjs/messages/OperationMessageContainer.d.ts

@@ -0,0 +1,24 @@
+import { OperationMessageHandlerAll } from "./OperationMessageHandler";
+/**
+ * Operation message container properties
+ * 操作消息容器属性
+ */
+export type OperationMessageContainerProps = {
+    /**
+     * Handler
+     * 处理器
+     */
+    handler: OperationMessageHandlerAll;
+    /**
+     * Timeout miliseconds
+     * 超时毫秒
+     */
+    timeout?: number;
+};
+/**
+ * Operation message container
+ * 操作消息容器
+ * @param props Props
+ * @returns Component
+ */
+export declare function OperationMessageContainer(props: OperationMessageContainerProps): import("react/jsx-runtime").JSX.Element;

package/lib/mjs/messages/OperationMessageDto.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Operation message data
+ * 操作信息数据
+ */
+export type OperationMessageDto = {
+    /**
+     * Operation type
+     * 操作类型
+     */
+    operationType: string;
+    /**
+     * Device id
+     * 设备编号
+     */
+    deviceId: number;
+    /**
+     * Target object id
+     * 目标对象编号
+     */
+    id?: number;
+    /**
+     * Related fields to pass more data
+     * 相关字段，便于传递更多数据
+     */
+    fields?: unknown[];
+};

package/lib/mjs/messages/OperationMessageHandler.d.ts

@@ -0,0 +1,24 @@
+import { OperationMessageDto } from "./OperationMessageDto";
+import { SignalRUser } from "./SignalRUser";
+/**
+ * Operation message handler type
+ * 操作消息处理程序类型
+ */
+export type OperationMessageHandler = (
+/**
+ * Signal user data
+ */
+user: SignalRUser | undefined, 
+/**
+ * Is current self user
+ */
+isSelf: boolean, 
+/**
+ * Message
+ */
+message: OperationMessageDto) => void;
+/**
+ * Operation message handler type for pages
+ * 操作消息处理程序类型（页面）
+ */
+export type OperationMessageHandlerAll = [types: string[], handler: () => void] | [types: string[], handler: () => void, id: number] | OperationMessageHandler;

package/lib/mjs/messages/RefreshHandler.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Refresh handler type
+ * 刷新处理程序类型
+ */
+export type RefreshHandler = () => void;

package/lib/mjs/messages/SignalRUser.d.ts

@@ -0,0 +1,31 @@
+import { UserRole } from "@etsoo/appscript";
+/**
+ * SignalR user
+ */
+export type SignalRUser = {
+    /**
+     * Global id, not local system user id
+     * 全局用户编号，不是子系统用户编号
+     */
+    id: number;
+    /**
+     * Name
+     * 姓名
+     */
+    name: string;
+    /**
+     * Avatar
+     * 头像
+     */
+    avatar?: string;
+    /**
+     * Device id
+     * 设备编号
+     */
+    deviceId: number;
+    /**
+     * Role
+     * 角色
+     */
+    role?: UserRole;
+};

package/lib/mjs/pages/CommonPage.d.ts

@@ -0,0 +1,72 @@
+import React from "react";
+import { ContainerProps, Theme } from "@mui/material";
+import type { CustomFabSize } from "../CustomFabProps";
+import type { IStateUpdate, ListItemReact } from "@etsoo/react";
+import type { UserKey } from "@etsoo/appscript";
+/**
+ * Common page props
+ * Default container id is 'pageContainer'
+ */
+export interface CommonPageProps extends Omit<ContainerProps, "id"> {
+    /**
+     * Fab buttons
+     */
+    fabButtons?: React.ReactNode;
+    /**
+     * Fab size
+     */
+    fabSize?: CustomFabSize;
+    /**
+     * Fab flex column direction, undefined to hide it
+     */
+    fabColumnDirection?: boolean;
+    /**
+     * Fab padding adjust
+     */
+    fabPaddingAdjust?: number;
+    /**
+     * Add panel to the Fab
+     */
+    fabPanel?: boolean;
+    /**
+     * Fab lays in the top
+     */
+    fabTop?: ((theme: Theme, padding: {}) => object) | boolean;
+    /**
+     * More actions
+     */
+    moreActions?: ListItemReact[];
+    /**
+     * On refresh callback, only when authorized = true
+     */
+    onRefresh?: () => void | PromiseLike<void>;
+    /**
+     * On page update, when authorized = null or true case, may uses onRefresh
+     */
+    onUpdate?: () => void | PromiseLike<void>;
+    /**
+     * On page update, all cases with authorized
+     */
+    onUpdateAll?: IStateUpdate;
+    /**
+     * Paddings
+     */
+    paddings?: number | Record<string, string | number>;
+    /**
+     * Scroll container
+     */
+    scrollContainer?: HTMLElement | object;
+    /**
+     * Support back click
+     */
+    supportBack?: boolean;
+    /**
+     * State last changed fields
+     */
+    targetFields?: UserKey[];
+}
+/**
+ * Common page
+ * @param props Props
+ */
+export declare function CommonPage(props: CommonPageProps): import("react/jsx-runtime").JSX.Element;

package/lib/{pages → mjs/pages}/CommonPage.js

@@ -25,21 +25,31 @@ export function CommonPage(props) {
     // Labels
     const labels = Labels.CommonPage;
     // Update
+    const updateRef = React.useRef(false);
     const update = onUpdateAll
         ? onUpdateAll
         : onUpdate
-            ? (authorized) => {
-                if (authorized == null || authorized)
-                    onUpdate();
+            ? async (authorized) => {
+                if (authorized == null || authorized) {
+                    await onUpdate();
+                    updateRef.current = true;
+                }
             }
             : onRefresh
-                ? (authorized) => {
-                    if (authorized)
-                        onRefresh();
+                ? async (authorized) => {
+                    if (authorized) {
+                        await onRefresh();
+                        updateRef.current = true;
+                    }
                 }
                 : undefined;
     const theme = useTheme();
     const distance = React.useMemo(() => MUGlobal.updateWithTheme(fabPadding, theme.spacing), [fabPadding, theme.spacing]);
+    React.useEffect(() => {
+        if (updateRef.current && update) {
+            update(true, []);
+        }
+    }, [update]);
     // Return the UI
     return (_jsxs(React.Fragment, { children: [update && (_jsx(ReactAppStateDetector, { targetFields: targetFields, update: update })), _jsxs(Container, { disableGutters: disableGutters, maxWidth: maxWidth, sx: sx, id: "page-container", ...rest, children: [_jsxs(FabBox, { sx: {
                             zIndex: 1,

package/lib/mjs/pages/DataGridPage.d.ts

@@ -0,0 +1,7 @@
+import type { DataGridPageProps } from "./DataGridPageProps";
+/**
+ * DataGrid page
+ * @param props Props
+ * @returns Component
+ */
+export declare function DataGridPage<T extends object, F>(props: DataGridPageProps<T, F>): import("react/jsx-runtime").JSX.Element;

package/lib/mjs/pages/DataGridPageProps.d.ts

@@ -0,0 +1,18 @@
+import { GridJsonData, GridTemplateType } from "@etsoo/react";
+import type { DataGridExProps } from "../DataGridEx";
+import type { SearchPageProps } from "./SearchPageProps";
+/**
+ * DataGrid page props
+ */
+export type DataGridPageProps<T extends object, F> = DataGridExProps<T, GridJsonData & GridTemplateType<F>> & SearchPageProps<T, F> & {
+    /**
+     * Height will be deducted
+     * @param height Current calcuated height
+     * @param rect Current rect data
+     */
+    adjustHeight?: number | ((height: number, rect: DOMRect) => number);
+    /**
+     * Grid height
+     */
+    height?: number;
+};

package/lib/mjs/pages/DrawerHeader.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Common drawer header
+ */
+export declare const DrawerHeader: import("@emotion/styled").StyledComponent<import("@mui/system").MUIStyledCommonProps<import("@mui/material").Theme>, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;

package/lib/mjs/pages/EditPage.d.ts

@@ -0,0 +1,46 @@
+import React, { FormEventHandler } from "react";
+import { CommonPageProps } from "./CommonPage";
+import type { OperationMessageHandlerAll } from "../messages/OperationMessageHandler";
+/**
+ * Add / Edit page props
+ */
+export interface EditPageProps extends Omit<CommonPageProps, "onSubmit"> {
+    /**
+     * Is editing
+     */
+    isEditing?: boolean;
+    /**
+     * On form submit
+     */
+    onSubmit?: FormEventHandler<HTMLFormElement>;
+    /**
+     * On delete callback
+     */
+    onDelete?: () => Promise<void> | void;
+    /**
+     * Submit button disabled or not
+     */
+    submitDisabled?: boolean;
+    /**
+     * Support back click
+     * @default true
+     */
+    supportBack?: boolean;
+    /**
+     * Bottom part
+     */
+    bottomPart?: React.ReactNode;
+    /**
+     * Top part
+     */
+    topPart?: React.ReactNode;
+    /**
+     * Operation message handler
+     */
+    operationMessageHandler?: OperationMessageHandlerAll;
+}
+/**
+ * Add / Edit page
+ * @param props Props
+ */
+export declare function EditPage(props: EditPageProps): import("react/jsx-runtime").JSX.Element;

package/lib/mjs/pages/FixedListPage.d.ts

@@ -0,0 +1,14 @@
+import type { ListPageProps } from "./ListPage";
+/**
+ * Fixed height list page
+ * @param props Props
+ * @returns Component
+ */
+export declare function FixedListPage<T extends object, F>(props: ListPageProps<T, F> & {
+    /**
+     * Height will be deducted
+     * @param height Current calcuated height
+     * @param rect Current rect data
+     */
+    adjustHeight?: number | ((height: number, rect: DOMRect) => number);
+}): import("react/jsx-runtime").JSX.Element;

package/lib/mjs/pages/LeftDrawer.d.ts

@@ -0,0 +1,35 @@
+import React from "react";
+/**
+ * Left drawer props
+ */
+export type LeftDrawerProps = React.PropsWithRef<{
+    /**
+     * Show when md up
+     */
+    mdUp: boolean;
+    /**
+     * Organization
+     */
+    organization?: number;
+    /**
+     * Width
+     */
+    width: number;
+    /**
+     * Application name
+     */
+    appName?: string;
+    /**
+     * Logo URL
+     */
+    logoUrl?: string;
+    /**
+     * Is open or not
+     */
+    open?: boolean;
+    /**
+     * Minimize hanlder
+     */
+    onMinimize?: () => void;
+}>;
+export declare function LeftDrawer(props: React.PropsWithChildren<LeftDrawerProps>): import("react/jsx-runtime").JSX.Element;

package/lib/mjs/pages/ListPage.d.ts

@@ -0,0 +1,12 @@
+import { ScrollerListExProps } from "../ScrollerListEx";
+import type { SearchPageProps } from "./SearchPageProps";
+/**
+ * List page props
+ */
+export type ListPageProps<T extends object, F> = SearchPageProps<T, F> & Omit<ScrollerListExProps<T>, "loadData">;
+/**
+ * List page
+ * @param props Props
+ * @returns Component
+ */
+export declare function ListPage<T extends object, F>(props: ListPageProps<T, F>): import("react/jsx-runtime").JSX.Element;

package/lib/mjs/pages/ResponsivePage.d.ts

@@ -0,0 +1,56 @@
+import React from "react";
+import type { DataGridPageProps } from "./DataGridPageProps";
+import type { ScrollerListExInnerItemRendererProps, ScrollerListExItemSize } from "../ScrollerListEx";
+import { ListChildComponentProps } from "react-window";
+import { GridMethodRef } from "@etsoo/react";
+import type { OperationMessageHandlerAll } from "../messages/OperationMessageHandler";
+/**
+ * Response page props
+ */
+export type ResponsePageProps<T extends object, F> = DataGridPageProps<T, F> & {
+    /**
+     *
+     * @param height Current height
+     * @param isGrid Is displaying DataGrid
+     * @returns Adjusted height
+     */
+    adjustFabHeight?: (height: number, isGrid: boolean) => number;
+    /**
+     * Min width to show Datagrid
+     */
+    dataGridMinWidth?: number;
+    /**
+     * Inner item renderer
+     */
+    innerItemRenderer: (props: ScrollerListExInnerItemRendererProps<T>) => React.ReactNode;
+    /**
+     * Item renderer
+     */
+    itemRenderer?: (props: ListChildComponentProps<T>) => React.ReactElement;
+    /**
+     * Item size, a function indicates its a variable size list
+     */
+    itemSize: ScrollerListExItemSize;
+    /**
+     * Methods
+     */
+    mRef?: React.MutableRefObject<GridMethodRef<T> | undefined>;
+    /**
+     * Pull to refresh data
+     */
+    pullToRefresh?: boolean;
+    /**
+     * Quick action for double click or click under mobile
+     */
+    quickAction?: (data: T) => void;
+    /**
+     * Operation message handler
+     */
+    operationMessageHandler?: OperationMessageHandlerAll;
+};
+/**
+ * Fixed height list page
+ * @param props Props
+ * @returns Component
+ */
+export declare function ResponsivePage<T extends object, F>(props: ResponsePageProps<T, F>): import("react/jsx-runtime").JSX.Element;

package/lib/mjs/pages/SearchPageProps.d.ts

@@ -0,0 +1,36 @@
+import type { GridJsonData, GridLoader, GridTemplateType } from "@etsoo/react";
+import type { CommonPageProps } from "./CommonPage";
+/**
+ * Search page props
+ */
+export type SearchPageProps<T extends object, F> = GridLoader<T, GridJsonData & GridTemplateType<F>> & {
+    /**
+     * Cache key
+     */
+    cacheKey?: string;
+    /**
+     * Cache minutes
+     */
+    cacheMinutes?: number;
+    /**
+     * Search fields
+     */
+    fields: React.ReactElement[] | ((data: GridTemplateType<F>) => React.ReactElement[]);
+    /**
+     * Search field template
+     */
+    readonly fieldTemplate: F;
+    /**
+     * Page props
+     */
+    pageProps?: CommonPageProps;
+    /**
+     * Size ready to read miliseconds span
+     * @default 100
+     */
+    sizeReadyMiliseconds?: number;
+    /**
+     * SearchBar height
+     */
+    searchBarHeight?: number;
+};

package/lib/mjs/pages/TablePage.d.ts

@@ -0,0 +1,13 @@
+import { DataTypes, IdDefaultType } from "@etsoo/shared";
+import { TableExProps } from "../TableEx";
+import type { SearchPageProps } from "./SearchPageProps";
+/**
+ * Table page props
+ */
+export type TablePageProps<T extends object, F, D extends DataTypes.Keys<T>> = SearchPageProps<T, F> & Omit<TableExProps<T, D>, "loadData">;
+/**
+ * Table page
+ * @param props Props
+ * @returns Component
+ */
+export declare function TablePage<T extends object, F, D extends DataTypes.Keys<T> = IdDefaultType<T>>(props: TablePageProps<T, F, D>): import("react/jsx-runtime").JSX.Element;