@sdata/web-vue 1.11.0 → 1.12.0

package/es/cascader/types.d.ts

@@ -0,0 +1,79 @@
+import type { VirtualListProps } from '../_components/virtual-list/interface';
+import type { Size } from '../_utils/constant';
+import type { TriggerProps } from '../trigger';
+import type { CascaderFallback, CascaderFieldNames, CascaderFormatLabel, CascaderLoadMore, CascaderModelValue, CascaderOption } from './interface';
+export type CascaderExpandTrigger = 'click' | 'hover';
+export interface CascaderProps {
+    pathMode?: boolean;
+    multiple?: boolean;
+    modelValue?: CascaderModelValue;
+    value?: CascaderModelValue;
+    defaultValue?: CascaderModelValue;
+    options?: CascaderOption[];
+    disabled?: boolean;
+    error?: boolean;
+    size?: Size;
+    allowSearch?: boolean;
+    filterable?: boolean;
+    allowClear?: boolean;
+    clearable?: boolean;
+    inputValue?: string;
+    defaultInputValue?: string;
+    popupVisible?: boolean;
+    show?: boolean;
+    expandTrigger?: CascaderExpandTrigger;
+    defaultPopupVisible?: boolean;
+    defaultShow?: boolean;
+    placeholder?: string;
+    filterOption?: (inputValue: string, option: CascaderOption) => boolean;
+    popupContainer?: string | HTMLElement;
+    maxTagCount?: number | 'responsive';
+    showPath?: boolean;
+    separator?: string;
+    formatLabel?: CascaderFormatLabel;
+    triggerProps?: TriggerProps;
+    checkStrictly?: boolean;
+    loadMore?: CascaderLoadMore;
+    loading?: boolean;
+    searchOptionOnlyLabel?: boolean;
+    searchDelay?: number;
+    fieldNames?: CascaderFieldNames;
+    valueKey?: string;
+    fallback?: boolean | CascaderFallback;
+    expandChild?: boolean;
+    virtualListProps?: VirtualListProps;
+    tagNowrap?: boolean;
+}
+export type CascaderEmits = {
+    'update:modelValue': [value: CascaderModelValue];
+    'update:value': [value: CascaderModelValue];
+    'update:popupVisible': [visible: boolean];
+    'update:show': [visible: boolean];
+    'change': [value: CascaderModelValue];
+    'inputValueChange': [value: string];
+    'clear': [];
+    'search': [value: string];
+    'popupVisibleChange': [visible: boolean];
+    'showChange': [visible: boolean];
+    'focus': [ev: FocusEvent];
+    'blur': [ev: FocusEvent];
+};
+export interface CascaderPanelProps {
+    pathMode?: boolean;
+    multiple?: boolean;
+    modelValue?: CascaderModelValue;
+    value?: CascaderModelValue;
+    defaultValue?: CascaderModelValue;
+    options?: CascaderOption[];
+    expandTrigger?: CascaderExpandTrigger;
+    checkStrictly?: boolean;
+    loadMore?: CascaderLoadMore;
+    fieldNames?: CascaderFieldNames;
+    valueKey?: string;
+    expandChild?: boolean;
+}
+export type CascaderPanelEmits = {
+    'update:modelValue': [value: CascaderModelValue];
+    'update:value': [value: CascaderModelValue];
+    'change': [value: CascaderModelValue];
+};

package/es/checkbox/checkbox-group.js

@@ -8,20 +8,47 @@ import { computed, createVNode, defineComponent, provide, reactive, ref, toRefs,
 var checkbox_group_default = /* @__PURE__ */ defineComponent({
 	name: "CheckboxGroup",
 	props: {
+		/**
+		* @zh 绑定值
+		* @en Value
+		* @vModel
+		*/
 		modelValue: {
 			type: Array,
 			default: void 0
 		},
+		/**
+		* @zh 默认值（非受控状态）
+		* @en Default value (uncontrolled state)
+		*/
 		defaultValue: {
 			type: Array,
 			default: () => []
 		},
+		/**
+		* @zh 支持最多选中的数量
+		* @en Support the maximum number of selections
+		* @version 2.36.0
+		*/
 		max: { type: Number },
+		/**
+		* @zh 选项
+		* @en Options
+		* @version 2.27.0
+		*/
 		options: { type: Array },
+		/**
+		* @zh 复选框的排列方向
+		* @en Arrangement direction of checkboxes
+		*/
 		direction: {
 			type: String,
 			default: "horizontal"
 		},
+		/**
+		* @zh 是否禁用
+		* @en Whether to disable
+		*/
 		disabled: {
 			type: Boolean,
 			default: false
@@ -29,8 +56,29 @@ var checkbox_group_default = /* @__PURE__ */ defineComponent({
 	},
 	emits: {
 		"update:modelValue": (_value) => true,
+		/**
+		* @zh 值改变时触发
+		* @en Trigger when the value changes
+		* @param {(string | number | boolean)[]} value
+		* @param {Event} ev
+		*/
 		"change": (_value, _ev) => true
 	},
+	/**
+	* @zh checkbox 文案内容
+	* @en checkbox label content
+	* @slot label
+	* @binding {CheckboxOption} data
+	* @version 2.27.0
+	*/
+	/**
+	* @zh 自定义复选框
+	* @en Custom checkbox
+	* @slot checkbox
+	* @binding {boolean} checked
+	* @binding {boolean} disabled
+	* @version 2.27.0
+	*/
 	setup(props, { emit, slots }) {
 		const { disabled } = toRefs(props);
 		const prefixCls = getPrefixCls("checkbox-group");

package/es/checkbox/checkbox.js

@@ -13,23 +13,44 @@ var checkbox_default = /* @__PURE__ */ defineComponent({
 		IconHover: icon_hover_default
 	},
 	props: {
+		/**
+		* @zh 绑定值
+		* @en Value
+		* @vModel
+		*/
 		modelValue: {
 			type: [Boolean, Array],
 			default: void 0
 		},
+		/**
+		* @zh 默认是否选中（非受控状态）
+		* @en Whether checked by default (uncontrolled state)
+		*/
 		defaultChecked: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 选项的 `value`
+		* @en The `value` of the option
+		*/
 		value: { type: [
 			String,
 			Number,
 			Boolean
 		] },
+		/**
+		* @zh 是否禁用
+		* @en Whether to disable
+		*/
 		disabled: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 是否为半选状态
+		* @en Whether it is half-selected
+		*/
 		indeterminate: {
 			type: Boolean,
 			default: false
@@ -41,8 +62,22 @@ var checkbox_default = /* @__PURE__ */ defineComponent({
 	},
 	emits: {
 		"update:modelValue": (_value) => true,
+		/**
+		* @zh 值改变时触发
+		* @en Trigger when the value changes
+		* @param { boolean | (string | number | boolean)[] } value
+		* @param {Event} ev
+		*/
 		"change": (_value, _ev) => true
 	},
+	/**
+	* @zh 自定义复选框
+	* @en Custom checkbox
+	* @slot checkbox
+	* @binding {boolean} checked
+	* @binding {boolean} disabled
+	* @version 2.18.0
+	*/
 	setup(props, { emit, slots }) {
 		const { disabled, modelValue } = toRefs(props);
 		const prefixCls = getPrefixCls("checkbox");

package/es/collapse/collapse-item.js

@@ -14,20 +14,56 @@ var collapse_item_default = /* @__PURE__ */ defineComponent({
 		IconCaretLeft
 	},
 	props: {
+		/**
+		* @zh 面板的标题
+		* @en The title of the panel
+		*/
 		header: String,
+		/**
+		* @zh 是否禁用
+		* @en Whether to disable
+		*/
 		disabled: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 是否显示展开图标
+		* @en Whether to show the expand icon
+		*/
 		showExpandIcon: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 是否在隐藏时销毁内容
+		* @en Whether to destroy content when hidden
+		* @version 2.27.0
+		*/
 		destroyOnHide: {
 			type: Boolean,
 			default: false
 		}
 	},
+	/**
+	* @zh 面板的标题
+	* @en The title of the panel
+	* @slot header
+	*/
+	/**
+	* @zh 展开图标
+	* @en Expand icon
+	* @slot expand-icon
+	* @binding {boolean} active
+	* @binding {boolean} disabled
+	* @binding {'left' | 'right'} position
+	* @version 2.33.0
+	*/
+	/**
+	* @zh 额外内容
+	* @en Extra Content
+	* @slot extra
+	*/
 	setup(props, { slots }) {
 		var _instance$vnode$key;
 		const instance = getCurrentInstance();

package/es/collapse/collapse.vue_vue_type_script_lang.js

@@ -6,37 +6,84 @@ import { computed, defineComponent, provide, reactive, ref, toRefs } from "vue";
 var collapse_vue_vue_type_script_lang_default = defineComponent({
 	name: "Collapse",
 	props: {
+		/**
+		* @zh 当前展开的面板的 `key`
+		* @en The `key` of the currently expanded panel
+		* @vModel
+		*/
 		activeKey: {
 			type: Array,
 			default: void 0
 		},
+		/**
+		* @zh 默认展开的面板的 `key` （非受控模式）
+		* @en The `key` of the panel expanded by default (uncontrolled mode)
+		*/
 		defaultActiveKey: {
 			type: Array,
 			default: () => []
 		},
+		/**
+		* @zh 是否开启手风琴模式
+		* @en Whether to enable accordion mode
+		*/
 		accordion: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 是否显示展开图标
+		* @en Whether to show the expand icon
+		* @version 2.33.0
+		*/
 		showExpandIcon: {
 			type: Boolean,
 			default: void 0
 		},
+		/**
+		* @zh 展开图标显示的位置
+		* @en The location where the expand icon is displayed
+		* @values 'left', 'right'
+		*/
 		expandIconPosition: {
 			type: String,
 			default: "left"
 		},
+		/**
+		* @zh 是否显示边框
+		* @en Whether to show the border
+		*/
 		bordered: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 是否在隐藏时销毁内容
+		* @en Whether to destroy content when hidden
+		* @version 2.27.0
+		*/
 		destroyOnHide: {
 			type: Boolean,
 			default: false
 		}
 	},
+	/**
+	* @zh 展开图标
+	* @en Expand icon
+	* @slot expand-icon
+	* @binding {boolean} active
+	* @binding {boolean} disabled
+	* @binding {'left' | 'right'} position
+	* @version 2.33.0
+	*/
 	emits: {
 		"update:activeKey": (_activeKey) => true,
+		/**
+		* @zh 展开的面板发生改变时触发
+		* @en Emitted when the expanded panel changes
+		* @param {(string | number)[]} activeKey
+		* @param {Event} ev
+		*/
 		"change": (_activeKey, _ev) => true
 	},
 	setup(props, { emit, slots }) {

package/es/color-picker/color-picker.js

@@ -1,4 +1,4 @@
-import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.124.0/helpers/objectSpread2.js";
+import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.130.0/helpers/objectSpread2.js";
 import { getPrefixCls } from "../_utils/global-config.js";
 import Input from "../input/index.js";
 import Trigger from "../trigger/index.js";
@@ -20,56 +20,145 @@ var color_picker_default = /* @__PURE__ */ defineComponent({
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 色值
+		* @en Value
+		*/
 		value: String,
 		modelValue: String,
+		/**
+		* @zh 默认色值
+		* @en Default value
+		*/
 		defaultValue: {
 			type: String,
 			default: ""
 		},
+		/**
+		* @zh 格式化色值
+		* @en Value format
+		*/
 		format: {
 			type: String,
 			default: "RGB"
 		},
+		/**
+		* @zh 尺寸
+		* @en Size
+		* @values 'mini','small','medium','large'
+		*/
 		size: {
 			type: String,
 			default: "medium"
 		},
+		/**
+		* @zh 是否开启透明通道
+		* @en Whether alpha channel is enabled
+		*/
 		enableAlpha: Boolean,
+		/**
+		* @zh 是否展示颜色预览块
+		* @en Whether to show primary color preview
+		*/
 		showPrimaryColorPreview: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 输入框透传属性
+		* @en Input props
+		*/
 		inputProps: { type: Object },
+		/**
+		* @zh 最近使用颜色
+		* @en Recent colors
+		*/
 		recentColors: {
 			type: [Array, Boolean],
 			default: void 0
 		},
+		/**
+		* @zh 最近使用颜色，非受控
+		* @en Default recent colors
+		*/
 		defaultRecentColors: {
 			type: [Array, Boolean],
 			default: () => []
 		},
+		/**
+		* @zh 系统色板
+		* @en Swatch colors
+		*/
 		swatchColors: {
 			type: Array,
 			default: void 0
 		},
+		/**
+		* @zh 是否禁用
+		* @en Disabled
+		*/
 		disabled: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 是否内联面板。兼容旧版 hideTrigger 语义
+		* @en Render panel inline
+		*/
 		hideTrigger: Boolean,
+		/**
+		* @zh 透传 Trigger 组件属性
+		* @en Trigger props
+		*/
 		triggerProps: { type: Object },
+		/**
+		* @zh 兼容旧版历史颜色
+		* @en Legacy history colors
+		*/
 		historyColors: { type: Array },
+		/**
+		* @zh 兼容旧版预设颜色
+		* @en Legacy preset colors
+		*/
 		presetColors: { type: Array },
+		/**
+		* @zh 兼容旧版显示文字
+		* @en Legacy show text
+		*/
 		showText: Boolean,
+		/**
+		* @zh 兼容旧版显示历史色
+		* @en Legacy show history
+		*/
 		showHistory: Boolean,
+		/**
+		* @zh 兼容旧版显示预设色
+		* @en Legacy show preset
+		*/
 		showPreset: Boolean,
+		/**
+		* @zh 兼容旧版禁用透明通道
+		* @en Legacy disable alpha
+		*/
 		disabledAlpha: Boolean,
+		/**
+		* @zh 兼容 tdesign 的选择输入框透传属性，当前版本未使用
+		* @en Select input props
+		*/
 		selectInputProps: { type: Object }
 	},
 	emits: {
 		"update:modelValue": (_value) => true,
 		"update:value": (_value) => true,
+		/**
+		* @zh 颜色值改变时触发
+		* @en Triggered when the color value changes
+		*/
 		"change": (_value, _context) => true,
+		/**
+		* @zh 颜色面板展开和收起时触发
+		* @en Triggered when the color panel is expanded and collapsed
+		*/
 		"popup-visible-change": (_visible, _value) => true,
 		"clear": (_context) => true,
 		"palette-bar-change": (_context) => true,

package/es/color-picker/panel.js

@@ -1,4 +1,4 @@
-import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.124.0/helpers/objectSpread2.js";
+import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.130.0/helpers/objectSpread2.js";
 import { getPrefixCls } from "../_utils/global-config.js";
 import input_group_default from "../input/input-group.js";
 import Input from "../input/index.js";
@@ -386,7 +386,10 @@ var panel_default = /* @__PURE__ */ defineComponent({
 					"hideButton": true,
 					"disabled": props.disabled,
 					"modelValue": colorState.value.gradientDegree,
-					"onChange": (value = 0) => emitStateChange(setGradientDegree(colorState.value, value), "input")
+					"onChange": (value) => {
+						if (typeof value !== "number") return;
+						emitStateChange(setGradientDegree(colorState.value, value), "input");
+					}
 				}, null)]),
 				createVNode("div", {
 					"class": `${prefixCls}-gradient-preview`,

package/es/color-picker/utils.js

@@ -1,4 +1,4 @@
-import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.124.0/helpers/objectSpread2.js";
+import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.130.0/helpers/objectSpread2.js";
 import { formatInputToHSVA, hsvToRgb, rgbToHex, rgbToHsv, rgbaToHex } from "../_utils/color.js";
 //#region components/color-picker/utils.ts
 var DEFAULT_HSVA = {

package/es/comment/comment.js

@@ -1,4 +1,4 @@
-import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.124.0/helpers/objectSpread2.js";
+import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.130.0/helpers/objectSpread2.js";
 import { getPrefixCls } from "../_utils/global-config.js";
 import { isString } from "../_utils/is.js";
 import _plugin_vue_export_helper_default from "../_virtual/_plugin-vue_export-helper.js";
@@ -8,15 +8,61 @@ import { computed, createCommentVNode, createElementBlock, createElementVNode, d
 var _sfc_main = defineComponent({
 	name: "Comment",
 	props: {
+		/**
+		* @zh 作者名
+		* @en Display as the comment author
+		*/
 		author: { type: String },
+		/**
+		* @zh 头像
+		* @en Display as the comment avatar
+		*/
 		avatar: { type: String },
+		/**
+		* @zh 评论内容
+		* @en The content of the comment
+		*/
 		content: { type: String },
+		/**
+		* @zh 时间描述
+		* @en Display as the comment datetime
+		*/
 		datetime: { type: String },
+		/**
+		* @zh 靠左/靠右 展示 datetime 和 actions
+		* @en Alignment of `datetime` and `actions`
+		* @values 'left', 'right', { datetime?: "left" | "right"; actions?: "left" | "right" }
+		* */
 		align: {
 			type: [String, Object],
 			default: "left"
 		}
 	},
+	/**
+	* @zh 头像
+	* @en Avatar
+	* @slot avatar
+	*/
+	/**
+	* @zh 作者
+	* @en Author name
+	* @slot author
+	*/
+	/**
+	* @zh 时间描述
+	* @en Datetime info
+	* @slot datetime
+	*/
+	/**
+	* @zh 评论内容
+	* @en Comment content
+	* @slot content
+	*/
+	/**
+	* @zh 操作列表
+	* @en Action list
+	* @slot actions
+	*/
 	setup(props, { slots }) {
 		const prefixCls = getPrefixCls("comment");
 		const [hasAuthor, hasAvatar, hasContent, hasDatetime] = [