mdui 1.0.2 → 2.0.0

package/functions/alert.d.ts

@@ -0,0 +1,80 @@
+import '@mdui/jq/methods/on.js';
+import type { Dialog } from '../components/dialog.js';
+interface Options {
+    /**
+     * alert 的标题
+     */
+    headline?: string;
+    /**
+     * alert 的描述文本
+     */
+    description?: string;
+    /**
+     * alert 顶部的 Material Icons 图标名
+     */
+    icon?: string;
+    /**
+     * 是否在按下 ESC 键时，关闭 alert
+     */
+    closeOnEsc?: boolean;
+    /**
+     * 是否在点击遮罩层时，关闭 alert
+     */
+    closeOnOverlayClick?: boolean;
+    /**
+     * 确认按钮的文本
+     */
+    confirmText?: string;
+    /**
+     * 队列名称。
+     * 默认不启用队列，在多次调用该函数时，将同时显示多个 alert。
+     * 可在该参数中传入一个队列名称，具有相同队列名称的 alert 函数，将在上一个 alert 关闭后才打开下一个 alert。
+     * `dialog()`、`alert()`、`confirm()`、`prompt()` 这四个函数的队列名称若相同，则也将互相共用同一个队列。
+     */
+    queue?: string;
+    /**
+     * 点击确认按钮时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * 默认点击确认按钮后会关闭 alert；若返回值为 `false`，则不关闭 alert；若返回值为 promise，则将在 promise 被 resolve 后，关闭 alert。
+     * @param dialog
+     */
+    onConfirm?: (dialog: Dialog) => void | boolean | Promise<void>;
+    /**
+     * alert 开始打开时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onOpen?: (dialog: Dialog) => void;
+    /**
+     * alert 打开动画完成时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onOpened?: (dialog: Dialog) => void;
+    /**
+     * alert 开始关闭时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onClose?: (dialog: Dialog) => void;
+    /**
+     * alert 关闭动画完成时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onClosed?: (dialog: Dialog) => void;
+    /**
+     * 点击遮罩层时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onOverlayClick?: (dialog: Dialog) => void;
+}
+/**
+ * 打开一个 alert，返回 Promise。
+ * 如果是通过点击确定按钮关闭，则返回的 promise 会被 resolve；
+ * 如果是通过其他方式关闭，则返回的 promise 会被 reject。
+ * @param options
+ */
+export declare const alert: (options: Options) => Promise<void>;
+export {};

package/functions/alert.js

@@ -0,0 +1,59 @@
+import isPromise from 'is-promise';
+import { $ } from '@mdui/jq/$.js';
+import '@mdui/jq/methods/on.js';
+import { isUndefined, returnTrue } from '@mdui/jq/shared/helper.js';
+import { dialog as openDialog } from './dialog.js';
+const defaultOptions = {
+    confirmText: '确定',
+    onConfirm: returnTrue,
+};
+/**
+ * 打开一个 alert，返回 Promise。
+ * 如果是通过点击确定按钮关闭，则返回的 promise 会被 resolve；
+ * 如果是通过其他方式关闭，则返回的 promise 会被 reject。
+ * @param options
+ */
+export const alert = (options) => {
+    const mergedOptions = Object.assign({}, defaultOptions, options);
+    const properties = [
+        'headline',
+        'description',
+        'icon',
+        'closeOnEsc',
+        'closeOnOverlayClick',
+        'queue',
+        'onOpen',
+        'onOpened',
+        'onClose',
+        'onClosed',
+        'onOverlayClick',
+    ];
+    return new Promise((resolve, reject) => {
+        let isResolve = false;
+        const dialog = openDialog({
+            ...Object.fromEntries(properties
+                .filter((key) => !isUndefined(mergedOptions[key]))
+                .map((key) => [key, mergedOptions[key]])),
+            actions: [
+                {
+                    text: mergedOptions.confirmText,
+                    onClick: (dialog) => {
+                        const clickResult = mergedOptions.onConfirm.call(dialog, dialog);
+                        if (isPromise(clickResult)) {
+                            clickResult.then(() => {
+                                isResolve = true;
+                            });
+                        }
+                        else if (clickResult !== false) {
+                            isResolve = true;
+                        }
+                        return clickResult;
+                    },
+                },
+            ],
+        });
+        $(dialog).on('close', () => {
+            isResolve ? resolve() : reject();
+        });
+    });
+};

package/functions/breakpoint.d.ts

@@ -0,0 +1 @@
+export { breakpoint } from '@mdui/shared/helpers/breakpoint.js';

package/functions/breakpoint.js

@@ -0,0 +1 @@
+export { breakpoint } from '@mdui/shared/helpers/breakpoint.js';

package/functions/confirm.d.ts

@@ -0,0 +1,95 @@
+import '@mdui/jq/methods/on.js';
+import type { Dialog } from '../components/dialog.js';
+interface Options {
+    /**
+     * confirm 的标题
+     */
+    headline?: string;
+    /**
+     * confirm 的描述文本
+     */
+    description?: string;
+    /**
+     * confirm 顶部的 Material Icons 图标名
+     */
+    icon?: string;
+    /**
+     * 是否在按下 ESC 键时，关闭 confirm
+     */
+    closeOnEsc?: boolean;
+    /**
+     * 是否在点击遮罩层时，关闭 confirm
+     */
+    closeOnOverlayClick?: boolean;
+    /**
+     * 确认按钮的文本
+     */
+    confirmText?: string;
+    /**
+     * 取消按钮的文本
+     */
+    cancelText?: string;
+    /**
+     * 是否垂直排列底部操作按钮
+     */
+    stackedActions?: boolean;
+    /**
+     * 队列名称。
+     * 默认不启用队列，在多次调用该函数时，将同时显示多个 confirm。
+     * 可在该参数中传入一个队列名称，具有相同队列名称的 confirm 函数，将在上一个 confirm 关闭后才打开下一个 confirm。
+     * `dialog()`、`alert()`、`confirm()`、`prompt()` 这四个函数的队列名称若相同，则也将互相共用同一个队列。
+     */
+    queue?: string;
+    /**
+     * 点击确认按钮时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * 默认点击确认按钮后会关闭 confirm；若返回值为 `false`，则不关闭 confirm；若返回值为 promise，则将在 promise 被 resolve 后，关闭 confirm。
+     * @param dialog
+     */
+    onConfirm?: (dialog: Dialog) => void | boolean | Promise<void>;
+    /**
+     * 点击取消按钮时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * 默认点击确认按钮后会关闭 confirm；若返回值为 `false`，则不关闭 confirm；若返回值为 promise，则将在 promise 被 resolve 后，关闭 confirm。
+     * @param dialog
+     */
+    onCancel?: (dialog: Dialog) => void | boolean | Promise<void>;
+    /**
+     * confirm 开始打开时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onOpen?: (dialog: Dialog) => void;
+    /**
+     * confirm 打开动画完成时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onOpened?: (dialog: Dialog) => void;
+    /**
+     * confirm 开始关闭时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onClose?: (dialog: Dialog) => void;
+    /**
+     * confirm 关闭动画完成时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onClosed?: (dialog: Dialog) => void;
+    /**
+     * 点击遮罩层时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onOverlayClick?: (dialog: Dialog) => void;
+}
+/**
+ * 打开一个 confirm，返回 Promise。
+ * 如果是通过点击确定按钮关闭，则返回的 promise 会被 resolve；
+ * 如果是通过其他方式关闭，则返回的 promise 会被 reject。
+ * @param options
+ */
+export declare const confirm: (options: Options) => Promise<void>;
+export {};

package/functions/confirm.js

@@ -0,0 +1,68 @@
+import isPromise from 'is-promise';
+import { $ } from '@mdui/jq/$.js';
+import '@mdui/jq/methods/on.js';
+import { isUndefined, returnTrue } from '@mdui/jq/shared/helper.js';
+import { dialog as openDialog } from './dialog.js';
+const defaultOptions = {
+    confirmText: '确定',
+    cancelText: '取消',
+    onConfirm: returnTrue,
+    onCancel: returnTrue,
+};
+/**
+ * 打开一个 confirm，返回 Promise。
+ * 如果是通过点击确定按钮关闭，则返回的 promise 会被 resolve；
+ * 如果是通过其他方式关闭，则返回的 promise 会被 reject。
+ * @param options
+ */
+export const confirm = (options) => {
+    const mergedOptions = Object.assign({}, defaultOptions, options);
+    const properties = [
+        'headline',
+        'description',
+        'icon',
+        'closeOnEsc',
+        'closeOnOverlayClick',
+        'stackedActions',
+        'queue',
+        'onOpen',
+        'onOpened',
+        'onClose',
+        'onClosed',
+        'onOverlayClick',
+    ];
+    return new Promise((resolve, reject) => {
+        let isResolve = false;
+        const dialog = openDialog({
+            ...Object.fromEntries(properties
+                .filter((key) => !isUndefined(mergedOptions[key]))
+                .map((key) => [key, mergedOptions[key]])),
+            actions: [
+                {
+                    text: mergedOptions.cancelText,
+                    onClick: (dialog) => {
+                        return mergedOptions.onCancel.call(dialog, dialog);
+                    },
+                },
+                {
+                    text: mergedOptions.confirmText,
+                    onClick: (dialog) => {
+                        const clickResult = mergedOptions.onConfirm.call(dialog, dialog);
+                        if (isPromise(clickResult)) {
+                            clickResult.then(() => {
+                                isResolve = true;
+                            });
+                        }
+                        else if (clickResult !== false) {
+                            isResolve = true;
+                        }
+                        return clickResult;
+                    },
+                },
+            ],
+        });
+        $(dialog).on('close', () => {
+            isResolve ? resolve() : reject();
+        });
+    });
+};

package/functions/dialog.d.ts

@@ -0,0 +1,97 @@
+import '@mdui/jq/methods/append.js';
+import '@mdui/jq/methods/appendTo.js';
+import '@mdui/jq/methods/on.js';
+import '@mdui/jq/methods/remove.js';
+import '../components/button.js';
+import { Dialog } from '../components/dialog.js';
+import type { JQ } from '@mdui/jq/shared/core.js';
+interface Action {
+    /**
+     * 按钮文本
+     */
+    text: string;
+    /**
+     * 点击按钮时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * 默认点击按钮后会关闭 dialog；若返回值为 false，则不关闭 dialog；若返回值为 promise，则将在 promise 被 resolve 后，关闭 dialog。
+     * @param dialog
+     */
+    onClick?: (dialog: Dialog) => void | boolean | Promise<void>;
+}
+interface Options {
+    /**
+     * dialog 的标题
+     */
+    headline?: string;
+    /**
+     * dialog 的描述文本
+     */
+    description?: string;
+    /**
+     * dialog 中的 body 内容，可以是 HTML 字符串、DOM 元素、或 JQ 对象
+     */
+    body?: string | HTMLElement | JQ<HTMLElement>;
+    /**
+     * dialog 顶部的 Material Icons 图标名
+     */
+    icon?: string;
+    /**
+     * 是否在按下 ESC 键时，关闭 dialog
+     */
+    closeOnEsc?: boolean;
+    /**
+     * 是否在点击遮罩层时，关闭 dialog
+     */
+    closeOnOverlayClick?: boolean;
+    /**
+     * 底部操作按钮数组
+     */
+    actions?: Action[];
+    /**
+     * 是否垂直排列底部操作按钮
+     */
+    stackedActions?: boolean;
+    /**
+     * 队列名称。
+     * 默认不启用队列，在多次调用该函数时，将同时显示多个 dialog。
+     * 可在该参数中传入一个队列名称，具有相同队列名称的 dialog 函数，将在上一个 dialog 关闭后才打开下一个 dialog。
+     * `dialog()`、`alert()`、`confirm()`、`prompt()` 这四个函数的队列名称若相同，则也将互相共用同一个队列。
+     */
+    queue?: string;
+    /**
+     * dialog 开始打开时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onOpen?: (dialog: Dialog) => void;
+    /**
+     * dialog 打开动画完成时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onOpened?: (dialog: Dialog) => void;
+    /**
+     * dialog 开始关闭时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onClose?: (dialog: Dialog) => void;
+    /**
+     * dialog 关闭动画完成时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onClosed?: (dialog: Dialog) => void;
+    /**
+     * 点击遮罩层时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onOverlayClick?: (dialog: Dialog) => void;
+}
+/**
+ * 打开一个 dialog，返回 dialog 实例
+ * @param options
+ */
+export declare const dialog: (options: Options) => Dialog;
+export {};

package/functions/dialog.js

@@ -0,0 +1,100 @@
+import isPromise from 'is-promise';
+import { $ } from '@mdui/jq/$.js';
+import '@mdui/jq/methods/append.js';
+import '@mdui/jq/methods/appendTo.js';
+import '@mdui/jq/methods/on.js';
+import '@mdui/jq/methods/remove.js';
+import { returnTrue, toKebabCase } from '@mdui/jq/shared/helper.js';
+import { dequeue, queue } from '@mdui/shared/helpers/queue.js';
+import '../components/button.js';
+import { Dialog } from '../components/dialog.js';
+const defaultAction = {
+    onClick: returnTrue,
+};
+const queueName = 'mdui.functions.dialog.';
+let currentDialog = undefined;
+/**
+ * 打开一个 dialog，返回 dialog 实例
+ * @param options
+ */
+export const dialog = (options) => {
+    const dialog = new Dialog();
+    const $dialog = $(dialog);
+    const properties = [
+        'headline',
+        'description',
+        'icon',
+        'closeOnEsc',
+        'closeOnOverlayClick',
+        'stackedActions',
+    ];
+    const callbacks = ['onOpen', 'onOpened', 'onClose', 'onClosed', 'onOverlayClick'];
+    Object.entries(options).forEach(([key, value]) => {
+        // @ts-ignore
+        if (properties.includes(key)) {
+            // @ts-ignore
+            dialog[key] = value;
+            // @ts-ignore
+        }
+        else if (callbacks.includes(key)) {
+            const eventName = toKebabCase(key.slice(2));
+            $dialog.on(eventName, () => {
+                value.call(dialog, dialog);
+            });
+        }
+    });
+    if (options.body) {
+        $dialog.append(options.body);
+    }
+    if (options.actions) {
+        options.actions.forEach((action) => {
+            const mergedAction = Object.assign({}, defaultAction, action);
+            $(`<mdui-button
+        slot="action"
+        variant="text"
+      >${mergedAction.text}</mdui-button>`)
+                .appendTo($dialog)
+                .on('click', function () {
+                const clickResult = mergedAction.onClick.call(dialog, dialog);
+                if (isPromise(clickResult)) {
+                    this.loading = true;
+                    clickResult
+                        .then(() => {
+                        dialog.open = false;
+                    })
+                        .finally(() => {
+                        this.loading = false;
+                    });
+                }
+                else if (clickResult !== false) {
+                    dialog.open = false;
+                }
+            });
+        });
+    }
+    $dialog.appendTo('body').on('closed', () => {
+        $dialog.remove();
+        if (options.queue) {
+            currentDialog = undefined;
+            dequeue(queueName + options.queue);
+        }
+    });
+    if (!options.queue) {
+        setTimeout(() => {
+            dialog.open = true;
+        });
+    }
+    else if (currentDialog) {
+        queue(queueName + options.queue, () => {
+            dialog.open = true;
+            currentDialog = dialog;
+        });
+    }
+    else {
+        setTimeout(() => {
+            dialog.open = true;
+        });
+        currentDialog = dialog;
+    }
+    return dialog;
+};

package/functions/getColorFromImage.d.ts

@@ -0,0 +1,7 @@
+import type { JQ } from '@mdui/jq/shared/core.js';
+/**
+ * 根据指定的图片，提取出主色调的十六进制颜色值
+ * @param image `<img>` 元素的 CSS 选择器、或 `<img>` 元素、或 JQ 对象
+ * @return string 十六进制颜色值。例如：`#ff0000`
+ */
+export declare const getColorFromImage: (image: string | HTMLImageElement | JQ<HTMLImageElement>) => Promise<string>;

package/functions/getColorFromImage.js

@@ -0,0 +1,12 @@
+import { sourceColorFromImage, hexFromArgb, } from '@material/material-color-utilities';
+import { $ } from '@mdui/jq/$.js';
+/**
+ * 根据指定的图片，提取出主色调的十六进制颜色值
+ * @param image `<img>` 元素的 CSS 选择器、或 `<img>` 元素、或 JQ 对象
+ * @return string 十六进制颜色值。例如：`#ff0000`
+ */
+export const getColorFromImage = async (image) => {
+    const $image = $(image);
+    const source = await sourceColorFromImage($image[0]);
+    return hexFromArgb(source);
+};

package/functions/getTheme.d.ts

@@ -0,0 +1,10 @@
+import type { Theme } from './utils/theme.js';
+import type { JQ } from '@mdui/jq/shared/core.js';
+/**
+ * 获取在指定元素上设置的主题。
+ * 未传入参数时，默认获取 `<html>` 元素上的主题。
+ * 元素上未设置过主题时，默认返回 `light`。
+ * @param target 获取该元素上的主题。可以是 CSS 选择器、DOM 元素、或 JQ 对象。默认为 `<html>` 元素
+ * @return Theme 当前主题，值为 `light`、`dark` 或 `auto`
+ */
+export declare const getTheme: (target?: string | HTMLElement | JQ<HTMLElement>) => Theme;

package/functions/getTheme.js

@@ -0,0 +1,16 @@
+import { $ } from '@mdui/jq/$.js';
+/**
+ * 获取在指定元素上设置的主题。
+ * 未传入参数时，默认获取 `<html>` 元素上的主题。
+ * 元素上未设置过主题时，默认返回 `light`。
+ * @param target 获取该元素上的主题。可以是 CSS 选择器、DOM 元素、或 JQ 对象。默认为 `<html>` 元素
+ * @return Theme 当前主题，值为 `light`、`dark` 或 `auto`
+ */
+export const getTheme = (target = document.documentElement) => {
+    var _a, _b;
+    const element = $(target)[0];
+    const themes = ['light', 'dark', 'auto'];
+    const prefix = 'mdui-theme-';
+    return ((_b = (_a = Array.from(element.classList)
+        .find((className) => themes.map((theme) => prefix + theme).includes(className))) === null || _a === void 0 ? void 0 : _a.slice(prefix.length)) !== null && _b !== void 0 ? _b : 'light');
+};

package/functions/observeResize.d.ts

@@ -0,0 +1,2 @@
+export { observeResize } from '@mdui/shared/helpers/observeResize.js';
+export type { ObserveResize } from '@mdui/shared/helpers/observeResize.js';

package/functions/observeResize.js

@@ -0,0 +1 @@
+export { observeResize } from '@mdui/shared/helpers/observeResize.js';

package/functions/prompt.d.ts

@@ -0,0 +1,110 @@
+import '@mdui/jq/methods/on.js';
+import { TextField } from '../components/text-field.js';
+import type { Dialog } from '../components/dialog.js';
+interface Options {
+    /**
+     * prompt 的标题
+     */
+    headline?: string;
+    /**
+     * prompt 的描述文本
+     */
+    description?: string;
+    /**
+     * prompt 顶部的 Material Icons 图标名
+     */
+    icon?: string;
+    /**
+     * 是否在按下 ESC 键时，关闭 prompt
+     */
+    closeOnEsc?: boolean;
+    /**
+     * 是否在点击遮罩层时，关闭 prompt
+     */
+    closeOnOverlayClick?: boolean;
+    /**
+     * 确认按钮的文本
+     */
+    confirmText?: string;
+    /**
+     * 取消按钮的文本
+     */
+    cancelText?: string;
+    /**
+     * 是否垂直排列底部操作按钮
+     */
+    stackedActions?: boolean;
+    /**
+     * 队列名称。
+     * 默认不启用队列，在多次调用该函数时，将同时显示多个 prompt。
+     * 可在该参数中传入一个队列名称，具有相同队列名称的 prompt 函数，将在上一个 prompt 关闭后才打开下一个 prompt。
+     * `dialog()`、`alert()`、`confirm()`、`prompt()` 这四个函数的队列名称若相同，则也将互相共用同一个队列。
+     */
+    queue?: string;
+    /**
+     * 点击确认按钮时的回调函数。
+     * 函数参数为输入框的值和 dialog 实例，`this` 指向 dialog 实例。
+     * 默认点击确认按钮后会关闭 prompt；若返回值为 `false`，则不关闭 prompt；若返回值为 promise，则将在 promise 被 resolve 后，关闭 prompt。
+     * @param value
+     * @param dialog
+     */
+    onConfirm?: (value: string, dialog: Dialog) => void | boolean | Promise<void>;
+    /**
+     * 点击取消按钮时的回调函数。
+     * 函数参数为输入框的值和 dialog 实例，`this` 指向 dialog 实例。
+     * 默认点击取消按钮后会关闭 prompt；若返回值为 `false`，则不关闭 prompt；若返回值为 promise，则将在 promise 被 resolve 后，关闭 prompt。
+     * @param dialog
+     */
+    onCancel?: (value: string, dialog: Dialog) => void | boolean | Promise<void>;
+    /**
+     * prompt 开始打开时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onOpen?: (dialog: Dialog) => void;
+    /**
+     * prompt 打开动画完成时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onOpened?: (dialog: Dialog) => void;
+    /**
+     * prompt 开始关闭时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onClose?: (dialog: Dialog) => void;
+    /**
+     * prompt 关闭动画完成时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onClosed?: (dialog: Dialog) => void;
+    /**
+     * 点击遮罩层时的回调函数。
+     * 函数参数为 dialog 实例，`this` 也指向 dialog 实例。
+     * @param dialog
+     */
+    onOverlayClick?: (dialog: Dialog) => void;
+    /**
+     * 输入框的校验函数，参数为输入框的值。`this` 指向 TextField 实例。
+     * 将在浏览器原生验证 API 验证通过后，再使用该函数进行验证。
+     * 可以返回 `boolean` 值，为 `false` 时表示验证未通过，为 `true` 时表示验证通过。
+     * 也可以返回字符串，字符串不为空时表示验证未通过，同时返回的字符串将用作错误提示。
+     * 也可以返回 Promise，被 resolve 表示验证通过，被 reject 表示验证未通过，同时拒绝原因将用作错误提示。
+     * @param value
+     */
+    validator?: (value: string) => boolean | string | Promise<void>;
+    /**
+     * prompt 内部的输入框为 `<mdui-text-field>` 组件。可在该参数中设置 `<mdui-text-field>` 组件的参数。
+     */
+    textFieldOptions?: Partial<TextField>;
+}
+/**
+ * 打开一个 prompt，返回 Promise。
+ * 如果是通过点击确定按钮关闭，则返回的 promise 会被 resolve，resolve 的参数为输入框的值；
+ * 如果是通过其他方式关闭，则返回的 promise 会被 reject。
+ * @param options
+ */
+export declare const prompt: (options: Options) => Promise<string>;
+export {};