snail.vue 2.0.31 → 2.0.33

package/dist/snail.vue.d.ts

@@ -1,5 +1,5 @@
 import * as snail_core from 'snail.core';
-import { IAsyncScope, IScope, DateFormat, DateValue, TimeValue, RunResult } from 'snail.core';
+import { IAsyncScope, IScope, ScopeOptions, DateFormat, DateValue, TimeValue, RunResult } from 'snail.core';
 import * as vue from 'vue';
 import { Component, ShallowRef, Ref, WatchSource, App } from 'vue';
 import * as snail_view from 'snail.view';
@@ -913,13 +913,15 @@ interface IPopupManager {
 
 /**
  * 使用【弹窗管理器】
+ * @param options 配置选项
  * @returns 全新的【弹窗管理器】实例+作用域对象
  */
-declare function usePopup(): IPopupManager & IScope;
+declare function usePopup(options?: Pick<ScopeOptions, "global">): IPopupManager & IScope;
 
 /**
  * 滚动选择器 相关实体
  */
+
 /**
  * 滚动选择器 组件配置选项
  */
@@ -934,6 +936,15 @@ type ScrollPickerOptions = {
      */
     value?: string;
 };
+/**
+ * 滚动选择器 组件弹窗时配置选项
+ */
+type ScrollPickerPopupOptions = TitleOptions & {
+    /**
+     * 禁用【清空】按钮
+     */
+    clearDisabled?: boolean;
+};
 /**
  * 滚动选择器的一个滚动选项
  */
@@ -944,9 +955,9 @@ type ScrollPickItem = {
      */
     code: string;
     /**
-     * 选项文本
+     * 选项名称
      */
-    text: string;
+    name: string;
     /**
      * 是否禁用
      * - 为true,表示禁用此选项，不能被选中
@@ -1140,7 +1151,7 @@ interface IPickerManager {
      * @param options
      * @returns 异步任务，可销毁选择组件；可接受组件选择值
      */
-    showScroll(options: ScrollPickerOptions): IAsyncScope<string>;
+    showScroll(options: ScrollPickerOptions & ScrollPickerPopupOptions): IAsyncScope<string>;
 }
 /**
  * 选择器弹窗配置选项
@@ -1180,6 +1191,106 @@ type PickerExtend = {
     picker: IPickerManager;
 };
 
+/**
+ * 可操作项组件 的配置选项
+ * - disabled 为true时，不响应操作项触发
+ */
+type ActionOptions = DisabledOptions & ValueOptions<string> & {
+    /**
+     * 可用操作项
+     */
+    actions: ActionItem[];
+    /**
+     * 操作项触发模式
+     * - icon   （默认值）点击图标弹出操作项
+     * - press  长摁直接弹出操作项，此时隐藏触发icon
+     * - whole  整体触发：action组件点击时弹出操作项
+     */
+    mode?: "icon" | "whole" | "press";
+    /**
+     * 触发图标相关配置
+     * - hover   （默认值）鼠标移入显示一个触发图标，点击图标弹出操作项
+     * - always  始终显示一个触发图标，点击图标弹出操作项
+     */
+    icon?: "hover" | "always";
+    /**
+     * 选择操作项时的弹出方式
+     * - follow     跟随模式：跟随弹窗效果
+     * - picker     选择器模式：滚动选择器效果
+     */
+    popup?: "follow" | "picker";
+    /**
+     * 跟随弹窗配置
+     * - mode 为 `follow`时生效
+     */
+    follow?: Pick<FollowPositionOptions, "followX" | "followY" | "spaceX" | "spaceY">;
+};
+/**
+ * 操作项集合 组件渲染配置选项
+ */
+type ActionItemsOptions = {
+    /**
+     * 展示模式
+     * - horizontal 水平展示
+     * - vertical   垂直展示
+     */
+    mode: "horizontal" | "vertical";
+    /**
+     * 要渲染的操作项
+     */
+    actions: ActionItem[];
+};
+/**
+ * 一个操作项的配置
+ */
+type ActionItem = {
+    /**
+     * 操作项编码
+     * - 确保唯一
+     */
+    code: string;
+    /**
+     * 操作项名称
+     * - 确保唯一
+     */
+    name: string;
+    /**
+     * 操作项颜色
+     */
+    color?: string;
+    /**
+     * 操作项移入时颜色
+     */
+    hoverColor?: string;
+    /**
+     * 操作项图标
+     */
+    icon?: Pick<IconOptions, "type" | "size" | "title">;
+};
+/**
+ * 可操作向组件 插槽句柄
+ */
+type ActionSlotHandle = {
+    /**
+     * 操作项是否激活显示
+     */
+    isActived(): boolean;
+    /**
+     * 触发操作项显示
+     */
+    trigger(): void;
+};
+/**
+ * 可操作项组件 的事件
+ */
+type ActionEvents = {
+    /**
+     * 操作项激活时
+     * @param code 操作项的code
+     */
+    trigger: [code: string];
+};
+
 /**
  * 树形 数据相关的基础实体结构
  * 1、封装一些基础实体；如树形节点数据结构
@@ -2565,94 +2676,6 @@ type ButtonOptions = TitleOptions & {
     type: "primary" | "default" | "link";
 };
 
-/**
- * 可操作项组件 的配置选项
- * - disabled 为true时，不响应操作项触发
- */
-type ActionOptions = DisabledOptions & {
-    /**
-     * 触发方式
-     *  - always ：始终显示一个触发图标，点击图标弹出操作项
-     *  - hover：鼠标移入显示一个触发图标，点击图标弹出操作项
-     *  - long-press：长摁直接弹出操作项
-     */
-    trigger: "always" | "hover" | "long-press";
-    /**
-     * 显示模式
-     * - popup：弹出显示操作项
-     * - inline：内联显示操作项
-     */
-    /**
-     * 可用操作项
-     */
-    actions: ActionItem[];
-} & Pick<FollowPositionOptions, "followX" | "followY" | "spaceX" | "spaceY">;
-/**
- * 操作项集合 组件渲染配置选项
- */
-type ActionItemsOptions = {
-    /**
-     * 展示模式
-     * - horizontal 水平展示
-     * - vertical   垂直展示
-     */
-    mode: "horizontal" | "vertical";
-    /**
-     * 要渲染的操作项
-     */
-    actions: ActionItem[];
-};
-/**
- * 一个操作项的配置
- */
-type ActionItem = {
-    /**
-     * 操作项编码
-     * - 确保唯一
-     */
-    code: string;
-    /**
-     * 操作项名称
-     * - 确保唯一
-     */
-    name: string;
-    /**
-     * 操作项颜色
-     */
-    color?: string;
-    /**
-     * 操作项移入时颜色
-     */
-    hoverColor?: string;
-    /**
-     * 操作项图标
-     */
-    icon?: Pick<IconOptions, "type" | "size" | "title">;
-};
-/**
- * 可操作向组件 插槽句柄
- */
-type ActionSlotHandle = {
-    /**
-     * 操作项是否激活显示
-     */
-    isActived(): boolean;
-    /**
-     * 触发操作项显示
-     */
-    trigger(): void;
-};
-/**
- * 可操作项组件 的事件
- */
-type ActionEvents = {
-    /**
-     * 操作项激活时
-     * @param code 操作项的code
-     */
-    trigger: [code: string];
-};
-
 /**
  * 输入框配置选项
  * - title          将作为 输入框标题区域文本；不传入则不展示 标题区域，仅展示输入框
@@ -2948,46 +2971,12 @@ declare const MOTION: Readonly<{
 
 /**
  * 使用选择器
+ * @param options 配置选项
  * @returns 选择器实例+作用域对象
  */
-declare function usePicker(): IPickerManager & IScope;
+declare function usePicker(options?: Pick<ScopeOptions, "global">): IPickerManager & IScope;
 
 declare const components: {
-    Action: {
-        new (...args: any[]): vue.CreateComponentPublicInstanceWithMixins<Readonly<ActionOptions> & Readonly<{
-            onTrigger?: (code: string) => any;
-        }>, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-            trigger: (code: string) => any;
-        }, vue.PublicProps, {}, false, {}, {}, vue.GlobalComponents, vue.GlobalDirectives, string, {}, any, vue.ComponentProvideOptions, {
-            P: {};
-            B: {};
-            D: {};
-            C: {};
-            M: {};
-            Defaults: {};
-        }, Readonly<ActionOptions> & Readonly<{
-            onTrigger?: (code: string) => any;
-        }>, {}, {}, {}, {}, {}>;
-        __isFragment?: never;
-        __isTeleport?: never;
-        __isSuspense?: never;
-    } & vue.ComponentOptionsBase<Readonly<ActionOptions> & Readonly<{
-        onTrigger?: (code: string) => any;
-    }>, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-        trigger: (code: string) => any;
-    }, string, {}, {}, string, {}, vue.GlobalComponents, vue.GlobalDirectives, string, vue.ComponentProvideOptions> & vue.VNodeProps & vue.AllowedComponentProps & vue.ComponentCustomProps & (new () => {
-        $slots: {
-            default?: (props: {
-                isActived(): boolean;
-                trigger(): void;
-            }) => any;
-        } & {
-            trigger?: (props: {
-                isActived(): boolean;
-                trigger(): void;
-            }) => any;
-        };
-    });
     Button: {
         new (...args: any[]): vue.CreateComponentPublicInstanceWithMixins<Readonly<ButtonOptions> & Readonly<{
             onClick?: (evt?: MouseEvent | TouchEvent | PointerEvent) => any;
@@ -3745,6 +3734,41 @@ declare const components: {
             default?: (props: {}) => any;
         };
     });
+    Action: {
+        new (...args: any[]): vue.CreateComponentPublicInstanceWithMixins<Readonly<ActionOptions> & Readonly<{
+            onTrigger?: (code: string) => any;
+        }>, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+            trigger: (code: string) => any;
+        }, vue.PublicProps, {}, false, {}, {}, vue.GlobalComponents, vue.GlobalDirectives, string, {}, any, vue.ComponentProvideOptions, {
+            P: {};
+            B: {};
+            D: {};
+            C: {};
+            M: {};
+            Defaults: {};
+        }, Readonly<ActionOptions> & Readonly<{
+            onTrigger?: (code: string) => any;
+        }>, {}, {}, {}, {}, {}>;
+        __isFragment?: never;
+        __isTeleport?: never;
+        __isSuspense?: never;
+    } & vue.ComponentOptionsBase<Readonly<ActionOptions> & Readonly<{
+        onTrigger?: (code: string) => any;
+    }>, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+        trigger: (code: string) => any;
+    }, string, {}, {}, string, {}, vue.GlobalComponents, vue.GlobalDirectives, string, vue.ComponentProvideOptions> & vue.VNodeProps & vue.AllowedComponentProps & vue.ComponentCustomProps & (new () => {
+        $slots: {
+            default?: (props: {
+                isActived(): boolean;
+                trigger(): void;
+            }) => any;
+        } & {
+            trigger?: (props: {
+                isActived(): boolean;
+                trigger(): void;
+            }) => any;
+        };
+    });
     FlashNumber: vue.DefineComponent<{
         value?: string | number;
     }, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<{
@@ -3775,11 +3799,15 @@ declare const components: {
     }> & Readonly<{
         onChange?: (newValue: string, oldValue?: string) => any;
     }>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
-    ScrollPicker: vue.DefineComponent<ScrollPickerOptions & TitleOptions & Partial<PopupHandle<string> & {
+    ScrollPicker: vue.DefineComponent<ScrollPickerOptions & TitleOptions & {
+        clearDisabled?: boolean;
+    } & Partial<PopupHandle<string> & {
         onBeforeClose(fn: (data?: string) => false | undefined | Promise<false | undefined>): void;
     } & PopupStatusOptions & PickerExtend>, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
         select: (code: string) => any;
-    }, string, vue.PublicProps, Readonly<ScrollPickerOptions & TitleOptions & Partial<PopupHandle<string> & {
+    }, string, vue.PublicProps, Readonly<ScrollPickerOptions & TitleOptions & {
+        clearDisabled?: boolean;
+    } & Partial<PopupHandle<string> & {
         onBeforeClose(fn: (data?: string) => false | undefined | Promise<false | undefined>): void;
     } & PopupStatusOptions & PickerExtend>> & Readonly<{
         onSelect?: (code: string) => any;
@@ -3847,4 +3875,4 @@ declare const components: {
 };
 
 export { MOTION, components, getBuiltinIcon, mount, onAppCreated, triggerAppCreated, usePicker, usePopup, useReactive, useTreeContext };
-export type { ActionEvents, ActionItem, ActionItemsOptions, ActionOptions, ActionSlotHandle, ButtonOptions, ChangeEvents, ChooseEvents, ChooseItem, ChooseOptions, ClickEvents, CloseEvents, ComponentBindOptions, ComponentOptions, ConfirmAreaOptions, ConfirmOptions, DatePickerDayItem, DatePickerMonthItem, DatePickerOptions, DatePickerYearItem, DatetimeDisabledOptions, DatetimePickerEvents, DeleteEvents, DialogHandle, DialogOptions, DialogWrapperHandle, DisabledOptions, DragVerifyInfo, DragVerifyOptions, ElasticEvents, ElasticExpose, ElasticOptions, ElasticSpringStatus, EmitterType, EmptyOptions, EventsType, FlexOptions, FoldEvents, FoldOptions, FoldSlotHandle, FoldStatus, FollowElectResult, FollowExtend, FollowHandle, FollowOptions, FollowPositionOptions, FollowStrategy, FollowStrategyOptions, FooterEvents, FooterOptions, HeaderEvents, HeaderOptions, INumberFormatter, IPickerManager, IPopupManager, IReactiveManager, ISelectContext, ITreeBaseContext, IconOptions, IconType, InputEvents, InputOptions, LayoutAraeOptions, LayoutAreaItem, LayoutOptions, LoadingOptions, MessageOptions, MotionEffectOptions, MotionOptions, MoveEvents, NumberBaseOptions, NumberEvents, NumberFormatResult, NumberOptions, PickerExtend, PickerPopupOptions, PlaceholderOptions, PopupDescriptor, PopupHandle, PopupOptions, PopupStatus, PopupStatusOptions, PropsType, ReactiveVar, ReadonlyOptions, ScrollEvents, ScrollExpose, ScrollOptions, ScrollPickItem, ScrollPickerEvents, ScrollPickerOptions, SearchEvents, SearchOptions, SelectBaseEvents, SelectBaseOptions, SelectEvents, SelectItem, SelectNodeEvents, SelectNodeOptions, SelectOptions, SelectPopupEvents, SelectPopupExtend, SelectPopupOptions, SelectSlotOptions, SlotsType, SortEvent, SortEvents, SortGroupHook, SortGroupOptions, SortOptions, SwitchEvents, SwitchOptions, TableColOptions, TableOptions, TableRowOptions, TextareaEvents, TextareaOptions, TimePickerHourItem, TimePickerMinuteItem, TimePickerOptions, TimePickerSecondItem, TitleOptions, ToastOptions, TreeEvents, TreeNode, TreeNodeEvents, TreeNodeExtend, TreeNodeModel, TreeNodeOptions, TreeNodeRenderOptions, TreeNodeSlotOptions, TreeOptions, TreeSearchResult, ValueOptions, WrapperEvents, WrapperOptions };
+export type { ActionEvents, ActionItem, ActionItemsOptions, ActionOptions, ActionSlotHandle, ButtonOptions, ChangeEvents, ChooseEvents, ChooseItem, ChooseOptions, ClickEvents, CloseEvents, ComponentBindOptions, ComponentOptions, ConfirmAreaOptions, ConfirmOptions, DatePickerDayItem, DatePickerMonthItem, DatePickerOptions, DatePickerYearItem, DatetimeDisabledOptions, DatetimePickerEvents, DeleteEvents, DialogHandle, DialogOptions, DialogWrapperHandle, DisabledOptions, DragVerifyInfo, DragVerifyOptions, ElasticEvents, ElasticExpose, ElasticOptions, ElasticSpringStatus, EmitterType, EmptyOptions, EventsType, FlexOptions, FoldEvents, FoldOptions, FoldSlotHandle, FoldStatus, FollowElectResult, FollowExtend, FollowHandle, FollowOptions, FollowPositionOptions, FollowStrategy, FollowStrategyOptions, FooterEvents, FooterOptions, HeaderEvents, HeaderOptions, INumberFormatter, IPickerManager, IPopupManager, IReactiveManager, ISelectContext, ITreeBaseContext, IconOptions, IconType, InputEvents, InputOptions, LayoutAraeOptions, LayoutAreaItem, LayoutOptions, LoadingOptions, MessageOptions, MotionEffectOptions, MotionOptions, MoveEvents, NumberBaseOptions, NumberEvents, NumberFormatResult, NumberOptions, PickerExtend, PickerPopupOptions, PlaceholderOptions, PopupDescriptor, PopupHandle, PopupOptions, PopupStatus, PopupStatusOptions, PropsType, ReactiveVar, ReadonlyOptions, ScrollEvents, ScrollExpose, ScrollOptions, ScrollPickItem, ScrollPickerEvents, ScrollPickerOptions, ScrollPickerPopupOptions, SearchEvents, SearchOptions, SelectBaseEvents, SelectBaseOptions, SelectEvents, SelectItem, SelectNodeEvents, SelectNodeOptions, SelectOptions, SelectPopupEvents, SelectPopupExtend, SelectPopupOptions, SelectSlotOptions, SlotsType, SortEvent, SortEvents, SortGroupHook, SortGroupOptions, SortOptions, SwitchEvents, SwitchOptions, TableColOptions, TableOptions, TableRowOptions, TextareaEvents, TextareaOptions, TimePickerHourItem, TimePickerMinuteItem, TimePickerOptions, TimePickerSecondItem, TitleOptions, ToastOptions, TreeEvents, TreeNode, TreeNodeEvents, TreeNodeExtend, TreeNodeModel, TreeNodeOptions, TreeNodeRenderOptions, TreeNodeSlotOptions, TreeOptions, TreeSearchResult, ValueOptions, WrapperEvents, WrapperOptions };