@etsoo/materialui 1.4.68 → 1.4.70

package/lib/mjs/app/ReactApp.d.ts

@@ -0,0 +1,252 @@
+import { AppTryLoginParams, CoreApp, FormatResultCustomCallback, IApp, IAppSettings, ICoreApp, IUser } from "@etsoo/appscript";
+import { INotifier, NotificationReturn } from "@etsoo/notificationbase";
+import { DataTypes, IActionResult } from "@etsoo/shared";
+import React from "react";
+import { CultureAction, CultureState, INotificationReact, InputDialogProps, IPageData, IStateProps, NotificationReactCallProps, PageAction, PageState, UserAction, UserState } from "@etsoo/react";
+import { NavigateFunction, NavigateOptions } from "react-router";
+/**
+ * React Application Type
+ */
+export type ReactAppType = IApp & IReactAppBase;
+/**
+ * React application data
+ */
+export type ReactAppData<A extends ReactAppType> = {
+    /**
+     * Current application
+     */
+    app: A;
+};
+/**
+ * React application context
+ */
+export declare const ReactAppContext: React.Context<ReactAppData<ReactAppType> | null>;
+/**
+ * Global application
+ */
+export declare let globalApp: ReactAppType | null;
+/**
+ * React app state detector
+ * Case 1: undefined, when refresh the whole page
+ * Case 2: false, unauthorized
+ * Case 3: true, authorized or considered as authorized (maynot, like token expiry)
+ * Case 4: property or properties changed
+ * @param props Props
+ * @returns Component
+ */
+export declare function ReactAppStateDetector(props: IStateProps): React.FunctionComponentElement<{
+    children?: React.ReactNode | undefined;
+}>;
+/**
+ * React implemented base
+ */
+export interface IReactAppBase {
+    /**
+     * Override Notifier as React specific
+     */
+    readonly notifier: INotifier<React.ReactNode, NotificationReactCallProps>;
+    /**
+     * User state
+     */
+    readonly userState: UserState<any>;
+    /**
+     * Is screen size down 'sm'
+     */
+    smDown?: boolean;
+    /**
+     * Is screen size up 'md'
+     */
+    mdUp?: boolean;
+    /**
+     * Get date format props
+     * @returns Props
+     */
+    getDateFormatProps(): object;
+    /**
+     * Get money format props
+     * @param currency Currency, if undefined, default currency applied
+     * @returns Props
+     */
+    getMoneyFormatProps(currency?: string): object;
+    /**
+     * Set page data
+     * @param data Page data
+     */
+    setPageData(data: IPageData): void;
+    /**
+     * Set page title and subtitle
+     * @param title Page title
+     * @param subtitle Page subtitle
+     */
+    setPageTitle(title: string, subtitle?: string): void;
+    /**
+     * Set page title and data
+     * @param title Page title
+     */
+    setPageTitle(title: string): void;
+    /**
+     * Show input dialog
+     * @param props Props
+     */
+    showInputDialog({ title, message, callback, ...rest }: InputDialogProps): INotificationReact;
+}
+/**
+ * Core application interface
+ */
+export interface IReactApp<S extends IAppSettings, D extends IUser, P extends IPageData> extends ICoreApp<D, S, React.ReactNode, NotificationReactCallProps>, IReactAppBase {
+    /**
+     * User state
+     */
+    readonly userState: UserState<D>;
+    /**
+     * Set page data
+     * @param data Page data
+     */
+    setPageData(data: P): void;
+}
+/**
+ * React application
+ */
+export declare class ReactApp<S extends IAppSettings, D extends IUser, P extends IPageData> extends CoreApp<D, S, React.ReactNode, NotificationReactCallProps> implements IReactApp<S, D, P> {
+    private static _notifierProvider;
+    /**
+     * Get notifier provider
+     */
+    static get notifierProvider(): React.FunctionComponent<DataTypes.StringRecord>;
+    private static createNotifier;
+    /**
+     * Culture state
+     */
+    readonly cultureState: CultureState;
+    /**
+     * Page state
+     */
+    readonly pageState: PageState<P>;
+    /**
+     * User state
+     */
+    readonly userState: UserState<D>;
+    /**
+     * Is screen size down 'sm'
+     */
+    smDown?: boolean;
+    /**
+     * Is screen size up 'md'
+     */
+    mdUp?: boolean;
+    /**
+     * Navigate function
+     */
+    navigateFunction?: NavigateFunction;
+    /**
+     * Page state dispatch
+     */
+    pageStateDispatch?: React.Dispatch<PageAction<P>>;
+    /**
+     * User state dispatch
+     */
+    userStateDispatch?: React.Dispatch<UserAction<D>>;
+    /**
+     * Constructor
+     * @param settings Settings
+     * @param name Application name
+     * @param debug Debug mode
+     */
+    constructor(settings: S, name: string, debug?: boolean);
+    /**
+     * Override alert action result
+     * @param result Action result
+     * @param callback Callback
+     * @param forceToLocal Force to local labels
+     */
+    alertResult(result: IActionResult | string, callback?: NotificationReturn<void>, forceToLocal?: FormatResultCustomCallback): void;
+    /**
+     * Change culture
+     * @param culture New culture definition
+     */
+    changeCulture(culture: DataTypes.CultureDefinition): Promise<DataTypes.StringRecord>;
+    /**
+     * Change culture extended
+     * @param dispatch Dispatch method
+     * @param culture New culture definition
+     */
+    changeCultureEx(dispatch: React.Dispatch<CultureAction>, culture: DataTypes.CultureDefinition): void;
+    /**
+     * Get date format props
+     * @returns Props
+     */
+    getDateFormatProps(): {
+        culture: string;
+        timeZone: string | undefined;
+    };
+    /**
+     * Get money format props
+     * @param currency Currency, if undefined, default currency applied
+     * @returns Props
+     */
+    getMoneyFormatProps(currency?: string): {
+        culture: string;
+        currency: string;
+    };
+    /**
+     * Fresh countdown UI
+     * @param callback Callback
+     */
+    freshCountdownUI(callback?: () => PromiseLike<unknown>): void;
+    /**
+     * Try login
+     * @param data Try login parameters
+     * @returns Result
+     */
+    tryLogin(data?: AppTryLoginParams): Promise<boolean>;
+    /**
+     * Check if the action result should be ignored during try login
+     * @param result Action result
+     * @returns Result
+     */
+    protected tryLoginIgnoreResult(result: IActionResult): boolean;
+    /**
+     * Set page data
+     * @param data Page data
+     */
+    setPageData(data: P): void;
+    /**
+     * Set page title and subtitle
+     * @param title Page title
+     * @param subtitle Page subtitle
+     */
+    setPageTitle(title: string, subtitle?: string): void;
+    /**
+     * Navigate to Url or delta
+     * @param url Url or delta
+     * @param options Options
+     */
+    navigate<T extends number | string | URL>(to: T, options?: T extends number ? never : NavigateOptions): void;
+    /**
+     * Set page title and data
+     * @param key Page title resource key
+     */
+    setPageKey(key: string): void;
+    /**
+     * Show input dialog
+     * @param props Props
+     */
+    showInputDialog({ title, message, callback, ...rest }: InputDialogProps): INotificationReact;
+    /**
+     * User login extended
+     * @param user New user
+     * @param refreshToken Refresh token
+     * @param dispatch User state dispatch
+     */
+    userLogin(user: D, refreshToken: string, dispatch?: boolean): void;
+    /**
+     * User logout
+     * @param clearToken Clear refresh token or not
+     * @param noTrigger No trigger for state change
+     */
+    userLogout(clearToken?: boolean, noTrigger?: boolean): void;
+    /**
+     * User unauthorized
+     */
+    userUnauthorized(): void;
+}

package/lib/mjs/app/ServiceApp.d.ts

@@ -0,0 +1,76 @@
+import { ApiRefreshTokenDto, AppLoginParams, AppTryLoginParams, ExternalEndpoint, IApi, IApiPayload } from "@etsoo/appscript";
+import { IServiceApp } from "./IServiceApp";
+import { IServiceAppSettings } from "./IServiceAppSettings";
+import { IServicePageData } from "./IServicePage";
+import { IServiceUser, ServiceUserToken } from "./IServiceUser";
+import { ReactApp } from "./ReactApp";
+import { IActionResult } from "@etsoo/shared";
+/**
+ * Core Service App
+ * Service login to core system, get the refesh token and access token
+ * Use the acess token to the service api, get a service access token
+ * Use the new acess token and refresh token to login
+ */
+export declare class ServiceApp<U extends IServiceUser = IServiceUser, P extends IServicePageData = IServicePageData, S extends IServiceAppSettings = IServiceAppSettings> extends ReactApp<S, U, P> implements IServiceApp {
+    /**
+     * Core endpoint
+     */
+    protected coreEndpoint: ExternalEndpoint;
+    /**
+     * Core system API
+     */
+    readonly coreApi: IApi;
+    /**
+     * Core system origin
+     */
+    readonly coreOrigin: string;
+    private coreAccessToken;
+    /**
+     * Constructor
+     * @param settings Settings
+     * @param name Application name
+     * @param debug Debug mode
+     */
+    constructor(settings: S, name: string, debug?: boolean);
+    /**
+     * Load core system UI
+     * @param tryLogin Try login or not
+     */
+    loadCore(tryLogin?: boolean): void;
+    /**
+     * Go to the login page
+     * @param data Login parameters
+     */
+    toLoginPage(data?: AppLoginParams): void;
+    /**
+     * Signout, with userLogout and toLoginPage
+     * @param action Callback
+     */
+    signout(action?: () => void | boolean): Promise<void>;
+    /**
+     *
+     * @param user Current user
+     * @param core Core system API token data
+     * @param keep Keep in local storage or not
+     * @param dispatch User state dispatch
+     */
+    userLoginEx(user: U & ServiceUserToken, core?: ApiRefreshTokenDto, dispatch?: boolean): void;
+    /**
+     * Save core system data
+     * @param data Data
+     */
+    protected saveCoreToken(data: ApiRefreshTokenDto): void;
+    /**
+     * Switch organization
+     * @param organizationId Organization ID
+     * @param fromOrganizationId From organization ID
+     * @param payload Payload
+     */
+    switchOrg(organizationId: number, fromOrganizationId?: number, payload?: IApiPayload<IActionResult<U & ServiceUserToken>>): Promise<IActionResult<U & ServiceUserToken> | undefined>;
+    protected refreshTokenSucceed(user: U, token: string, callback?: (result?: boolean | IActionResult) => boolean | void): Promise<void>;
+    /**
+     * Try login
+     * @param params Login parameters
+     */
+    tryLogin(params?: AppTryLoginParams): Promise<boolean>;
+}

package/lib/mjs/custom/CustomFieldUtils.d.ts

@@ -0,0 +1,56 @@
+import { CustomFieldData, CustomFieldSpace } from "@etsoo/appscript";
+import { CustomFieldReactCollection, ICustomFieldReact } from "@etsoo/react";
+import { IdType, ListType2 } from "@etsoo/shared";
+import { GridSize } from "@mui/material";
+import { TypographyProps } from "@mui/material/Typography";
+/**
+ * Custom field utilities
+ */
+export declare namespace CustomFieldUtils {
+    /**
+     * Custom field creators
+     */
+    const customFieldCreators: Record<string, ICustomFieldReact<any> | undefined>;
+    /**
+     * Create layout
+     * @param fields Fields
+     * @param collections Ref collections
+     * @param getValue Get default value callback
+     * @param onChange Callback for value change
+     * @param globalCallback Global label callback, can be repeated
+     * @param fieldCalback Field callback
+     * @returns
+     */
+    function create<D extends CustomFieldData = CustomFieldData>(fields: D[], collections: CustomFieldReactCollection<D>, getValue: (field: D) => unknown, onChange: (name: string, value: unknown) => void, globalCallback?: (input: string) => string, fieldCalback?: (field: D) => void): import("react/jsx-runtime").JSX.Element[];
+    /**
+     * Create multiline label
+     * @param label Original label
+     * @param props Properties
+     * @returns Result
+     */
+    function createMultilineLabel(label?: string, props?: TypographyProps): import("react/jsx-runtime").JSX.Element[] | undefined;
+    /**
+     * Transform custom field space
+     * @param space Space
+     * @returns Result
+     */
+    function transformSpace(space?: CustomFieldSpace): {
+        xs?: GridSize | null | undefined;
+        sm?: GridSize | null | undefined;
+        md?: GridSize | null | undefined;
+        lg?: GridSize | null | undefined;
+        xl?: GridSize | null | undefined;
+    };
+    /**
+     * Update ref options
+     * @param fields Fields
+     * @param callback Callback
+     */
+    function updateOptions(fields: CustomFieldData[], callback: (key: string, ids: IdType[]) => ListType2[]): void;
+    /**
+     * Update properties
+     * @param input Input object
+     * @param globalCallback Global callback
+     */
+    function updateProperties(input: object, globalCallback: (input: string) => string): void;
+}

package/lib/mjs/custom/CustomFieldViewer.d.ts

@@ -0,0 +1,50 @@
+import { CustomFieldData } from "@etsoo/appscript";
+import { Grid2Props, TypographyProps } from "@mui/material";
+/**
+ * Custom field viewer props
+ * 自定义字段查看器属性
+ */
+export type CustomFieldViewerProps = {
+    /**
+     * Custom fields
+     * 自定义字段
+     */
+    fields: CustomFieldData[];
+    /**
+     * Grid props
+     * 网格属性
+     */
+    gridProps?: Grid2Props;
+    /**
+     * JSON data
+     * JSON 数据
+     */
+    jsonData: unknown;
+    /**
+     * Title label props
+     * 标题标签属性
+     */
+    titleProps?: TypographyProps;
+    /**
+     * Vertical gap
+     * 垂直间距
+     */
+    verticalGap?: number;
+    /**
+     * Value label formatter
+     * 值标签格式化
+     */
+    valueLabelFormatter?: (value: any, field: CustomFieldData) => string;
+    /**
+     * Value label props
+     * 值标签属性
+     */
+    valueProps?: TypographyProps;
+};
+/**
+ * Custom field viewer
+ * 自定义字段查看器
+ * @param props Props
+ * @returns Component
+ */
+export declare function CustomFieldViewer(props: CustomFieldViewerProps): import("react/jsx-runtime").JSX.Element;

package/lib/mjs/custom/CustomFieldWindow.d.ts

@@ -0,0 +1,55 @@
+import { CustomFieldData } from "@etsoo/appscript";
+import { Grid2Props } from "@mui/material";
+import React from "react";
+/**
+ * Custom field window props
+ * 自定义字段窗口属性
+ */
+export type CustomFieldWindowProps<D extends CustomFieldData> = {
+    /**
+     * Children creation callback
+     * 子元素创建回调
+     * @param open Open callback
+     * @param label Label
+     * @param pc Property count
+     * @returns Component
+     */
+    children: (open: (customFields: D[], jsonData?: unknown) => void, label: string | undefined, pc: number) => React.ReactNode;
+    /**
+     * Label
+     * 标签
+     */
+    label?: string;
+    /**
+     * Grid props
+     * 网格属性
+     */
+    gridProps?: Grid2Props;
+    /**
+     * JSON data
+     * JSON 数据
+     */
+    jsonData?: unknown;
+    /**
+     * Input name
+     * 输入框名称
+     */
+    inputName?: string;
+    /**
+     * Input ref
+     * 输入框引用
+     */
+    inputRef?: React.MutableRefObject<HTMLInputElement | null>;
+    /**
+     * On update callback
+     * 更新回调
+     */
+    onUpdate?: (data: Record<string, unknown>) => void;
+};
+/**
+ * Custom field window
+ * 自定义字段窗口
+ * @param props Props
+ * @returns Component
+ */
+export declare function CustomFieldWindow<D extends CustomFieldData = CustomFieldData>(props: CustomFieldWindowProps<D>): import("react/jsx-runtime").JSX.Element;

package/lib/mjs/custom/FieldAmountLabel.d.ts

@@ -0,0 +1,7 @@
+import { ICustomFieldReact } from "@etsoo/react";
+/**
+ * Amount label field creator
+ * type: amountlabel
+ * @returns Component
+ */
+export declare const FieldAmountLabel: ICustomFieldReact<string>;

package/lib/mjs/custom/FieldCheckbox.d.ts

@@ -0,0 +1,8 @@
+import { ICustomFieldReact } from "@etsoo/react";
+import { IdType } from "@etsoo/shared";
+/**
+ * Checkbox (multiple values) field creator
+ * type: checkbox
+ * @returns Component
+ */
+export declare const FieldCheckbox: ICustomFieldReact<IdType[]>;

package/lib/mjs/custom/FieldCombobox.d.ts

@@ -0,0 +1,8 @@
+import { IdType } from "@etsoo/shared";
+import { ICustomFieldReact } from "@etsoo/react";
+/**
+ * Combobox (multiple values) field creator
+ * type combobox
+ * @returns Component
+ */
+export declare const FieldCombobox: ICustomFieldReact<IdType[]>;

package/lib/mjs/custom/FieldDateInput.d.ts

@@ -0,0 +1,7 @@
+import { ICustomFieldReact } from "@etsoo/react";
+/**
+ * Date input field creator
+ * type: date
+ * @returns Component
+ */
+export declare const FieldDateInput: ICustomFieldReact<Date>;

package/lib/mjs/custom/FieldDivider.d.ts

@@ -0,0 +1,7 @@
+import { ICustomFieldReact } from "@etsoo/react";
+/**
+ * Divider field creator
+ * type: divider
+ * @returns Component
+ */
+export declare const FieldDivider: ICustomFieldReact<unknown>;

package/lib/mjs/custom/FieldInput.d.ts

@@ -0,0 +1,7 @@
+import { ICustomFieldReact } from "@etsoo/react";
+/**
+ * Input field creator
+ * type: input
+ * @returns Component
+ */
+export declare const FieldInput: ICustomFieldReact<string>;

package/lib/mjs/custom/FieldJson.d.ts

@@ -0,0 +1,7 @@
+import { ICustomFieldReact } from "@etsoo/react";
+/**
+ * Textarea field creator
+ * type: json
+ * @returns Component
+ */
+export declare const FieldJson: ICustomFieldReact<object>;

package/lib/mjs/custom/FieldLabel.d.ts

@@ -0,0 +1,7 @@
+import { ICustomFieldReact } from "@etsoo/react";
+/**
+ * Label field creator
+ * type: label
+ * @returns Component
+ */
+export declare const FieldLabel: ICustomFieldReact<string>;

package/lib/mjs/custom/FieldNumberInput.d.ts

@@ -0,0 +1,7 @@
+import { ICustomFieldReact } from "@etsoo/react";
+/**
+ * Number input field creator
+ * type: number
+ * @returns Component
+ */
+export declare const FieldNumberInput: ICustomFieldReact<number>;

package/lib/mjs/custom/FieldRadio.d.ts

@@ -0,0 +1,8 @@
+import { ICustomFieldReact } from "@etsoo/react";
+import { IdType } from "@etsoo/shared";
+/**
+ * Radio (single value) field creator
+ * type: radio
+ * @returns Component
+ */
+export declare const FieldRadio: ICustomFieldReact<IdType>;

package/lib/mjs/custom/FieldSelect.d.ts

@@ -0,0 +1,8 @@
+import { IdType } from "@etsoo/shared";
+import { ICustomFieldReact } from "@etsoo/react";
+/**
+ * Select (single value) field creator
+ * type select
+ * @returns Component
+ */
+export declare const FieldSelect: ICustomFieldReact<IdType>;

package/lib/mjs/custom/FieldSwitch.d.ts

@@ -0,0 +1,7 @@
+import { ICustomFieldReact } from "@etsoo/react";
+/**
+ * Input field creator
+ * type: switch
+ * @returns Component
+ */
+export declare const FieldSwitch: ICustomFieldReact<boolean>;

package/lib/mjs/custom/FieldTexarea.d.ts

@@ -0,0 +1,7 @@
+import { ICustomFieldReact } from "@etsoo/react";
+/**
+ * Textarea field creator
+ * type: textarea
+ * @returns Component
+ */
+export declare const FieldTexarea: ICustomFieldReact<string>;