sard 1.1.0 → 1.2.0

package/index.js

@@ -18,7 +18,6 @@ import { defaultColorPickerPresets, defaultColorPickerValue, formatColor, getPre
 import { BarcodeFormatList, BarcodeTextPositionList, barcode, calculateBarcodeLayout, normalizeBarcodeOptions } from "./utils/barcode.js";
 import { measureTextWidth } from "./utils/canvas.js";
 import { clipboard } from "./utils/clipboard.js";
-import { OnlyChild, flatVNode } from "./utils/vnode.js";
 import { defineSetupFnComponent, enhanceComponent } from "./utils/component.js";
 import { Friction } from "./utils/scroller/Friction.js";
 import { Spring } from "./utils/scroller/Spring.js";
@@ -195,6 +194,7 @@ import { Table } from "./components/table/index.js";
 import { Tab, Tabs } from "./components/tabs/index.js";
 import { Tag } from "./components/tag/index.js";
 import { Text } from "./components/text/index.js";
+import { TextShrink } from "./components/text-shrink/index.js";
 import { Timeline, TimelineItem } from "./components/timeline/index.js";
 import { createToast, toast } from "./components/toast/imperative.js";
 import { Toast } from "./components/toast/index.js";
@@ -217,4 +217,4 @@ function prepareEnvironment() {
 	});
 }
 //#endregion
-export { ADD_SWIPER_CONTEXT_KEY, ALPHANUMERIC_CHARS, Accordion, AccordionItem, ActionSheet, ActionSheetItem, Alert, Avatar, AvatarGroup, BackTop, Badge, Barcode, BarcodeFormatList, BarcodeTextPositionList, Button, Calendar, CalendarInput, CalendarPopout, CancelError, Card, Cascader, CascaderInput, CascaderPopout, Checkbox, CheckboxGroup, CheckboxInput, CheckboxPopout, Col, Collapse, ColorPicker, ColorPickerInput, ColorPickerPopout, Compact, CoolIcon, CountDown, CountTo, CropImage, Danmaku, DateStrip, DatetimePicker, DatetimePickerInput, DatetimePickerPopout, DatetimeRangePicker, DatetimeRangePickerInput, DatetimeRangePickerPopout, Descriptions, DescriptionsItem, Dialog, Divider, Dnd, DndHandle, DndItem, Dropdown, DropdownItem, ECLList, Ellipsis, Empty, Fab, FabItem, Flex, FloatingBubble, FloatingPanel, Form, FormItem, FormItemPlain, FormPlain, Friction, Grid, GridItem, Image, Indexes, IndexesAnchor, IndexesNav, Input, Keyboard, KeyboardPopout, List, ListItem, LoadMore, LoadMoreStatus, Loading, Marquee, Menu, MenuItem, Motion, Navbar, NavbarItem, NavbarPit, NoticeBar, Notify, OnlyChild, Overlay, Pagination, PasswordInput, Picker, PickerInput, PickerPopout, PickerView, PickerViewColumn, Popout, PopoutInput, Popover, Popup, PreviewImage, ProgressBar, ProgressCircle, PullDownRefresh, PuzzleVerify, Qrcode, REMOVE_SWIPER_CONTEXT_KEY, Radio, RadioGroup, RadioInput, RadioPopout, Rate, ReadMore, Result, RotateVerify, Row, SWIPER_AUTO_HEIGHT_KEY, ScrollList, ScrollSpy, ScrollSpyAnchor, Search, Segmented, SegmentedItem, Select, SelectInput, SelectOption, SelectOptionGroup, SelectPopout, ShareSheet, ShareSheetIcon, ShareSheetItem, ShareSheetRow, Sidebar, SidebarItem, Signature, Skeleton, SkeletonAvatar, SkeletonBlock, SkeletonParagraph, SkeletonTitle, SlideVerify, Slider, Spring, StatusBar, Step, Stepper, Steps, Sticky, StickyBox, SwipeAction, Swiper, SwiperItem, Switch, Tab, Tabbar, TabbarItem, TabbarPit, Table, Tabs, Tag, Text, Timeline, TimelineItem, Toast, Tree, TreeBranch, TreeNode, Upload, UploadPreview, Waterfall, WaterfallItem, WaterfallLoad, Watermark, actionSheet, addSeparator, addUnit, arrayEqual, arrayMove, assignDeep, autoUpdate, barcode, baseLunarYear, calculateBarcodeLayout, camelCase, capitalize, chainGet, chainSet, checkRtl, chooseFile, clamp, clipboard, compactNumber, computePosition, createActionSheet, createBem, createBemStruct, createCropImage, createDialog, createInertialAnimate, createNotify, createPreviewImage, createToast, cropImage, cssVar, cssVarName, currentLocale, debounce, deepClone, defaultBemConfig, defaultColorPickerPresets, defaultColorPickerValue, defaultOptionKeys, defineSetupFnComponent, dialog, earthlyBranches, enhanceComponent, extend, flatVNode, flexGap, formatColor, formatDate, formatNumber, formatThousands, formatTime, getAspectFillSize, getAspectFitSize, getCurrentTime, getDampingValue, getDayOfYear, getDaysAfterLastDay, getDaysBeforeFirstDay, getDaysInMonth, getDaysSinceUnixEpoch, getDecimalsLength, getFileName, getFirstDayWeekday, getGridCenterSize, getGridIndex, getGridPrizeCount, getInBoundValue, getLeafNodes, getLunarDayName, getLunarHourName, getLunarLeapMonth, getLunarLeapMonthDays, getLunarMonthDays, getLunarMonthName, getLunarYearDays, getLunarYearName, getNextMonthDate, getNextMonthHeadDays, getNodeLevel, getOverflowRangeInArea, getPageRange, getPrevMonthDate, getPrevMonthTailDays, getPreviewColor, getRectDampingValue, getRotatedRect, getScrollIntoViewValue, getScrollTop, getTouchPoint, getTransformOrigin, getTreeCheckedKeys, getTreeHalfCheckedKeys, getTwoPointsDistance, heavenlyStems, hslToHsv, hslToHwb, hslToRgb, hsvToHsl, hwbToHsl, imageDataToDataURL, inRange, initializeCheckNodes, installer, interpolate, isBoolean, isCancelError, isColorScheme, isConfigObject, isDate, isEmptyArray, isEmptyBinding, isEmptyValue, isFileUrl, isFunction, isImageFile, isImageUrl, isKorean, isLeapYear, isNoEmptyArray, isNullish, isNumber, isObject, isPlainObject, isPrimitive, isRectEqual, isRenderVisible, isSizeEqual, isString, isUndefined, isVideoFile, isVideoUrl, isVisibleEmpty, kebabCase, loadImage, localeContextKey, logError, looseToNumber, lowerFirst, lunarDayNames, lunarInfo, lunarMonthNames, lunarToSolar, lunarYearNames, mapTreeToGrid, matchScrollVisible, measureTextWidth, minmaxDate, mround, nestedToMulti, noop, normalizeBarcodeOptions, normalizeHsla, normalizeHsva, notify, omit, omitFormPopoutProps, parseColor, parseDate, partition, partitionPopoutInputProps, pascalCase, pick, plateEnglishLetterKeys, plateProvinceKeys, plateSuffixKeys, popupManager, prepareEnvironment, previewImage, provideColorScheme, provideLocale, qrcode, random, reactiveComputed, readFileContent, rgbToHsl, round, safeAreaInsets, scrollToTarget, setCheckedRecursively, setLocale, shuffle, sleep, snakeCase, solarToLunar, splitUnit, spreadEach, springFestivals, throttle, toArray, toDate, toDateNumber, toDateString, toMonthNumber, toReactive, toTouchEvent, toast, treeToMap, truncToFixed, uniqid, updateAncestorsChecked, upperFirst, useClickOutside, useColorScheme, useComposition, useCountDown, useDragPinch, useElementBackTop, useElementScroll, useFormContext, useFormItem, useFormItemContext, useFormPopout, useInPopup, useIndeterminate, useInitialVelocity, useIntersectionObserver, useKeyList, useLocale, useLockScroll, useLuckyDraw, useLuckyGrid, useLuckyWheel, useMotioning, useOptionKeys, usePageBackTop, usePageScroll, usePointerDown, usePopoutInput, usePopper, usePopupEnter, usePopupVisibleHookProvide, useReachBottom, useResizeObserver, useRtl, useScrollSide, useScrollSpy, useScroller, useSimulatedClick, useSimulatedDblClick, useSimulatedPress, useSingleTask, useSlotMachine, useStopMovedClick, useTimeout, useTimeoutLoading, useTranslate, useTranslateWithPrefix, useWindowResize, useZIndex, walkAncestor, walkDescendant, walkNodes, windowInfo, withResolvers };
+export { ADD_SWIPER_CONTEXT_KEY, ALPHANUMERIC_CHARS, Accordion, AccordionItem, ActionSheet, ActionSheetItem, Alert, Avatar, AvatarGroup, BackTop, Badge, Barcode, BarcodeFormatList, BarcodeTextPositionList, Button, Calendar, CalendarInput, CalendarPopout, CancelError, Card, Cascader, CascaderInput, CascaderPopout, Checkbox, CheckboxGroup, CheckboxInput, CheckboxPopout, Col, Collapse, ColorPicker, ColorPickerInput, ColorPickerPopout, Compact, CoolIcon, CountDown, CountTo, CropImage, Danmaku, DateStrip, DatetimePicker, DatetimePickerInput, DatetimePickerPopout, DatetimeRangePicker, DatetimeRangePickerInput, DatetimeRangePickerPopout, Descriptions, DescriptionsItem, Dialog, Divider, Dnd, DndHandle, DndItem, Dropdown, DropdownItem, ECLList, Ellipsis, Empty, Fab, FabItem, Flex, FloatingBubble, FloatingPanel, Form, FormItem, FormItemPlain, FormPlain, Friction, Grid, GridItem, Image, Indexes, IndexesAnchor, IndexesNav, Input, Keyboard, KeyboardPopout, List, ListItem, LoadMore, LoadMoreStatus, Loading, Marquee, Menu, MenuItem, Motion, Navbar, NavbarItem, NavbarPit, NoticeBar, Notify, Overlay, Pagination, PasswordInput, Picker, PickerInput, PickerPopout, PickerView, PickerViewColumn, Popout, PopoutInput, Popover, Popup, PreviewImage, ProgressBar, ProgressCircle, PullDownRefresh, PuzzleVerify, Qrcode, REMOVE_SWIPER_CONTEXT_KEY, Radio, RadioGroup, RadioInput, RadioPopout, Rate, ReadMore, Result, RotateVerify, Row, SWIPER_AUTO_HEIGHT_KEY, ScrollList, ScrollSpy, ScrollSpyAnchor, Search, Segmented, SegmentedItem, Select, SelectInput, SelectOption, SelectOptionGroup, SelectPopout, ShareSheet, ShareSheetIcon, ShareSheetItem, ShareSheetRow, Sidebar, SidebarItem, Signature, Skeleton, SkeletonAvatar, SkeletonBlock, SkeletonParagraph, SkeletonTitle, SlideVerify, Slider, Spring, StatusBar, Step, Stepper, Steps, Sticky, StickyBox, SwipeAction, Swiper, SwiperItem, Switch, Tab, Tabbar, TabbarItem, TabbarPit, Table, Tabs, Tag, Text, TextShrink, Timeline, TimelineItem, Toast, Tree, TreeBranch, TreeNode, Upload, UploadPreview, Waterfall, WaterfallItem, WaterfallLoad, Watermark, actionSheet, addSeparator, addUnit, arrayEqual, arrayMove, assignDeep, autoUpdate, barcode, baseLunarYear, calculateBarcodeLayout, camelCase, capitalize, chainGet, chainSet, checkRtl, chooseFile, clamp, clipboard, compactNumber, computePosition, createActionSheet, createBem, createBemStruct, createCropImage, createDialog, createInertialAnimate, createNotify, createPreviewImage, createToast, cropImage, cssVar, cssVarName, currentLocale, debounce, deepClone, defaultBemConfig, defaultColorPickerPresets, defaultColorPickerValue, defaultOptionKeys, defineSetupFnComponent, dialog, earthlyBranches, enhanceComponent, extend, flexGap, formatColor, formatDate, formatNumber, formatThousands, formatTime, getAspectFillSize, getAspectFitSize, getCurrentTime, getDampingValue, getDayOfYear, getDaysAfterLastDay, getDaysBeforeFirstDay, getDaysInMonth, getDaysSinceUnixEpoch, getDecimalsLength, getFileName, getFirstDayWeekday, getGridCenterSize, getGridIndex, getGridPrizeCount, getInBoundValue, getLeafNodes, getLunarDayName, getLunarHourName, getLunarLeapMonth, getLunarLeapMonthDays, getLunarMonthDays, getLunarMonthName, getLunarYearDays, getLunarYearName, getNextMonthDate, getNextMonthHeadDays, getNodeLevel, getOverflowRangeInArea, getPageRange, getPrevMonthDate, getPrevMonthTailDays, getPreviewColor, getRectDampingValue, getRotatedRect, getScrollIntoViewValue, getScrollTop, getTouchPoint, getTransformOrigin, getTreeCheckedKeys, getTreeHalfCheckedKeys, getTwoPointsDistance, heavenlyStems, hslToHsv, hslToHwb, hslToRgb, hsvToHsl, hwbToHsl, imageDataToDataURL, inRange, initializeCheckNodes, installer, interpolate, isBoolean, isCancelError, isColorScheme, isConfigObject, isDate, isEmptyArray, isEmptyBinding, isEmptyValue, isFileUrl, isFunction, isImageFile, isImageUrl, isKorean, isLeapYear, isNoEmptyArray, isNullish, isNumber, isObject, isPlainObject, isPrimitive, isRectEqual, isRenderVisible, isSizeEqual, isString, isUndefined, isVideoFile, isVideoUrl, isVisibleEmpty, kebabCase, loadImage, localeContextKey, logError, looseToNumber, lowerFirst, lunarDayNames, lunarInfo, lunarMonthNames, lunarToSolar, lunarYearNames, mapTreeToGrid, matchScrollVisible, measureTextWidth, minmaxDate, mround, nestedToMulti, noop, normalizeBarcodeOptions, normalizeHsla, normalizeHsva, notify, omit, omitFormPopoutProps, parseColor, parseDate, partition, partitionPopoutInputProps, pascalCase, pick, plateEnglishLetterKeys, plateProvinceKeys, plateSuffixKeys, popupManager, prepareEnvironment, previewImage, provideColorScheme, provideLocale, qrcode, random, reactiveComputed, readFileContent, rgbToHsl, round, safeAreaInsets, scrollToTarget, setCheckedRecursively, setLocale, shuffle, sleep, snakeCase, solarToLunar, splitUnit, spreadEach, springFestivals, throttle, toArray, toDate, toDateNumber, toDateString, toMonthNumber, toReactive, toTouchEvent, toast, treeToMap, truncToFixed, uniqid, updateAncestorsChecked, upperFirst, useClickOutside, useColorScheme, useComposition, useCountDown, useDragPinch, useElementBackTop, useElementScroll, useFormContext, useFormItem, useFormItemContext, useFormPopout, useInPopup, useIndeterminate, useInitialVelocity, useIntersectionObserver, useKeyList, useLocale, useLockScroll, useLuckyDraw, useLuckyGrid, useLuckyWheel, useMotioning, useOptionKeys, usePageBackTop, usePageScroll, usePointerDown, usePopoutInput, usePopper, usePopupEnter, usePopupVisibleHookProvide, useReachBottom, useResizeObserver, useRtl, useScrollSide, useScrollSpy, useScroller, useSimulatedClick, useSimulatedDblClick, useSimulatedPress, useSingleTask, useSlotMachine, useStopMovedClick, useTimeout, useTimeoutLoading, useTranslate, useTranslateWithPrefix, useWindowResize, useZIndex, walkAncestor, walkDescendant, walkNodes, windowInfo, withResolvers };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sard",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "sard 是基于 Vue3 的 Web 移动端 UI 组件库",
   "keywords": [
     "UI",

package/utils/createImperativeComponent.d.ts

@@ -1,10 +1,17 @@
-import { type Component } from 'vue';
+import type { Component } from 'vue';
+interface ImperativeExpose<T> {
+    show: (options?: T) => void;
+    hide: () => void;
+}
 interface ImperativeConfig<Expose> {
     onShow?: (expose: Expose) => void;
     onHide?: (expose: Expose) => void;
 }
-export declare function createImperativeComponent<Options, Expose>(component: Component, defaultOptions?: Options, config?: ImperativeConfig<Expose>): {
-    show: (options?: Options) => void;
-    hide: () => void;
-};
+/**
+ * 创建一个命令式组件：挂载到 body 上的独立容器里，通过 `show` / `hide` 控制。
+ *
+ * 具体渲染由 `./imperative/imperative-agent.vue` 负责，挂载方式（vdom / vapor）
+ * 由 `./imperative/agent-runtime` 隔离，因此这里不含任何 vdom 专有 API。
+ */
+export declare function createImperativeComponent<Options, Expose>(component: Component, defaultOptions?: Options, config?: ImperativeConfig<Expose>): ImperativeExpose<Options>;
 export {};

package/utils/createImperativeComponent.js

@@ -1,44 +1,20 @@
-import { createApp, createVNode, defineComponent, ref } from "vue";
+import imperative_agent_default from "./imperative/imperative-agent.vue.js";
+import { mountAgent } from "./imperative/agent-runtime.js";
 //#region packages/sard/utils/createImperativeComponent.ts
-function createAgent(component, defaultOptions, config) {
-	return defineComponent({ setup(_, { expose }) {
-		const compRef = ref();
-		const innerProps = ref({});
-		const show = (options) => {
-			innerProps.value = {
-				...defaultOptions,
-				...options,
-				visible: true
-			};
-			config?.onShow?.(compRef.value);
-		};
-		const hide = () => {
-			innerProps.value = {
-				...innerProps.value,
-				visible: false
-			};
-			config?.onHide?.(compRef.value);
-		};
-		expose({
-			show,
-			hide
-		});
-		return () => {
-			return createVNode(component, {
-				ref: compRef,
-				...innerProps.value,
-				"onUpdate:visible": (value) => {
-					innerProps.value.visible = value;
-					innerProps.value["onUpdate:visible"]?.(value);
-				}
-			});
-		};
-	} });
-}
+/**
+* 创建一个命令式组件：挂载到 body 上的独立容器里，通过 `show` / `hide` 控制。
+*
+* 具体渲染由 `./imperative/imperative-agent.vue` 负责，挂载方式（vdom / vapor）
+* 由 `./imperative/agent-runtime` 隔离，因此这里不含任何 vdom 专有 API。
+*/
 function createImperativeComponent(component, defaultOptions, config) {
 	const container = document.createElement("div");
 	document.body.appendChild(container);
-	const instance = createApp(createAgent(component, defaultOptions, config)).mount(container);
+	const instance = mountAgent(imperative_agent_default, container, {
+		component,
+		defaultOptions,
+		config
+	});
 	function show(options) {
 		instance.show(options);
 	}

package/utils/imperative/agent-runtime.d.ts

@@ -0,0 +1,28 @@
+import { type Component } from 'vue';
+/**
+ * 挂载命令式组件的 Agent，并返回它 expose 出来的对象（`{ show, hide }`）。
+ *
+ * 这里是整个命令式体系里**唯一**依赖 vdom 运行时的点。vapor 变体（P0-2 双产物
+ * 时新增 `./agent-runtime.vapor.ts`，由构建把 `./agent-runtime` 指过去）只需换
+ * 一行 import，函数体完全相同：
+ *
+ * ```ts
+ * import { createVaporApp } from '@vue/runtime-vapor'
+ *
+ * export const mountAgent = (Agent, container, rootProps) =>
+ *   createVaporApp(Agent, rootProps).mount(container)
+ * ```
+ *
+ * 依据（已核对 vue 3.6 源码 + 官方测试）：
+ * - `createVaporApp` 内部是 `createAppAPI(mountApp, unmountApp, getExposed)`，
+ *   所以 `mount()` 返回的同样是 expose 代理，与 vdom 一致
+ *   （`runtime-vapor/__tests__/apiExpose.spec.ts` 的「with mount」用例：
+ *   `app.mount(host).foo === 1`）。
+ * - 根 props 同样支持：`createVaporApp(Comp, { count: () => 1 })`
+ *   （`apiCreateVaporApp.spec.ts` 的「mount with props」用例）。
+ *
+ * ⚠️ 唯一语义差异：vapor 把根 props 里的**函数值当作 getter**（动态 props）。
+ * 我们传的 `component` 若被传成「函数式组件」会被当成 getter —— 实际用法都是
+ * SFC / defineComponent 对象，不受影响，P0-2 时留意即可。
+ */
+export declare function mountAgent(Agent: Component, container: HTMLElement, rootProps: Record<string, any>): any;

package/utils/imperative/agent-runtime.js

@@ -0,0 +1,33 @@
+import { createApp } from "vue";
+//#region packages/sard/utils/imperative/agent-runtime.ts
+/**
+* 挂载命令式组件的 Agent，并返回它 expose 出来的对象（`{ show, hide }`）。
+*
+* 这里是整个命令式体系里**唯一**依赖 vdom 运行时的点。vapor 变体（P0-2 双产物
+* 时新增 `./agent-runtime.vapor.ts`，由构建把 `./agent-runtime` 指过去）只需换
+* 一行 import，函数体完全相同：
+*
+* ```ts
+* import { createVaporApp } from '@vue/runtime-vapor'
+*
+* export const mountAgent = (Agent, container, rootProps) =>
+*   createVaporApp(Agent, rootProps).mount(container)
+* ```
+*
+* 依据（已核对 vue 3.6 源码 + 官方测试）：
+* - `createVaporApp` 内部是 `createAppAPI(mountApp, unmountApp, getExposed)`，
+*   所以 `mount()` 返回的同样是 expose 代理，与 vdom 一致
+*   （`runtime-vapor/__tests__/apiExpose.spec.ts` 的「with mount」用例：
+*   `app.mount(host).foo === 1`）。
+* - 根 props 同样支持：`createVaporApp(Comp, { count: () => 1 })`
+*   （`apiCreateVaporApp.spec.ts` 的「mount with props」用例）。
+*
+* ⚠️ 唯一语义差异：vapor 把根 props 里的**函数值当作 getter**（动态 props）。
+* 我们传的 `component` 若被传成「函数式组件」会被当成 getter —— 实际用法都是
+* SFC / defineComponent 对象，不受影响，P0-2 时留意即可。
+*/
+function mountAgent(Agent, container, rootProps) {
+	return createApp(Agent, rootProps).mount(container);
+}
+//#endregion
+export { mountAgent };

package/utils/imperative/imperative-agent.vue.d.ts

@@ -0,0 +1,35 @@
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    component: {
+        type: null;
+        required: true;
+    };
+    defaultOptions: {
+        type: null;
+        default: undefined;
+    };
+    config: {
+        type: null;
+        default: undefined;
+    };
+}>, {
+    show: (options?: Record<string, any>) => void;
+    hide: () => void;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    component: {
+        type: null;
+        required: true;
+    };
+    defaultOptions: {
+        type: null;
+        default: undefined;
+    };
+    config: {
+        type: null;
+        default: undefined;
+    };
+}>> & Readonly<{}>, {
+    defaultOptions: any;
+    config: any;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/utils/imperative/imperative-agent.vue.js

@@ -0,0 +1,60 @@
+import { computed, createBlock, defineComponent, mergeProps, openBlock, ref, resolveDynamicComponent, useTemplateRef } from "vue";
+//#region packages/sard/utils/imperative/imperative-agent.vue
+var imperative_agent_default = /*@__PURE__*/ defineComponent({
+	__name: "imperative-agent",
+	props: {
+		component: {
+			type: null,
+			required: true
+		},
+		defaultOptions: {
+			type: null,
+			default: void 0
+		},
+		config: {
+			type: null,
+			default: void 0
+		}
+	},
+	setup(__props, { expose: __expose }) {
+		const props = __props;
+		const compRef = useTemplateRef("compRef");
+		const innerProps = ref({});
+		const boundProps = computed(() => {
+			return {
+				...innerProps.value,
+				"onUpdate:visible": (value) => {
+					innerProps.value.visible = value;
+					innerProps.value["onUpdate:visible"]?.(value);
+				}
+			};
+		});
+		const show = (options) => {
+			innerProps.value = {
+				...props.defaultOptions,
+				...options,
+				visible: true
+			};
+			props.config?.onShow?.(compRef.value);
+		};
+		const hide = () => {
+			innerProps.value = {
+				...innerProps.value,
+				visible: false
+			};
+			props.config?.onHide?.(compRef.value);
+		};
+		__expose({
+			show,
+			hide
+		});
+		return (_ctx, _cache) => {
+			return openBlock(), createBlock(resolveDynamicComponent(__props.component), mergeProps({
+				ref_key: "compRef",
+				ref: compRef
+			}, boundProps.value), null, 16);
+		};
+	}
+});
+//#endregion
+export { imperative_agent_default as default };

package/utils/index.d.ts

@@ -18,7 +18,6 @@ export * from './color';
 export * from './barcode';
 export * from './canvas';
 export * from './clipboard';
-export * from './vnode';
 export * from './component';
 export * from './scroller';
 export * from './polyfill';

package/utils/index.js

@@ -18,10 +18,9 @@ import { defaultColorPickerPresets, defaultColorPickerValue, formatColor, getPre
 import { BarcodeFormatList, BarcodeTextPositionList, barcode, calculateBarcodeLayout, normalizeBarcodeOptions } from "./barcode.js";
 import { measureTextWidth } from "./canvas.js";
 import { clipboard } from "./clipboard.js";
-import { OnlyChild, flatVNode } from "./vnode.js";
 import { defineSetupFnComponent, enhanceComponent } from "./component.js";
 import { Friction } from "./scroller/Friction.js";
 import { Spring } from "./scroller/Spring.js";
 import { withResolvers } from "./polyfill.js";
 import { useScroller } from "./scroller/useScroller.js";
-export { ALPHANUMERIC_CHARS, BarcodeFormatList, BarcodeTextPositionList, ECLList, Friction, OnlyChild, Spring, addSeparator, addUnit, arrayEqual, arrayMove, assignDeep, barcode, baseLunarYear, calculateBarcodeLayout, camelCase, capitalize, chainGet, chainSet, checkRtl, chooseFile, clamp, clipboard, compactNumber, createBem, createBemStruct, createInertialAnimate, cssVar, cssVarName, debounce, deepClone, defaultBemConfig, defaultColorPickerPresets, defaultColorPickerValue, defineSetupFnComponent, earthlyBranches, enhanceComponent, extend, flatVNode, formatColor, formatDate, formatNumber, formatThousands, getAspectFillSize, getAspectFitSize, getDampingValue, getDayOfYear, getDaysAfterLastDay, getDaysBeforeFirstDay, getDaysInMonth, getDaysSinceUnixEpoch, getDecimalsLength, getFileName, getFirstDayWeekday, getInBoundValue, getLeafNodes, getLunarDayName, getLunarHourName, getLunarLeapMonth, getLunarLeapMonthDays, getLunarMonthDays, getLunarMonthName, getLunarYearDays, getLunarYearName, getNextMonthDate, getNextMonthHeadDays, getNodeLevel, getOverflowRangeInArea, getPageRange, getPrevMonthDate, getPrevMonthTailDays, getPreviewColor, getRectDampingValue, getRotatedRect, getScrollIntoViewValue, getScrollTop, getTouchPoint, getTransformOrigin, getTreeCheckedKeys, getTreeHalfCheckedKeys, getTwoPointsDistance, heavenlyStems, hslToHsv, hslToHwb, hslToRgb, hsvToHsl, hwbToHsl, imageDataToDataURL, inRange, initializeCheckNodes, interpolate, isBoolean, isConfigObject, isDate, isEmptyArray, isEmptyBinding, isEmptyValue, isFileUrl, isFunction, isImageFile, isImageUrl, isKorean, isLeapYear, isNoEmptyArray, isNullish, isNumber, isObject, isPlainObject, isPrimitive, isRectEqual, isRenderVisible, isSizeEqual, isString, isUndefined, isVideoFile, isVideoUrl, isVisibleEmpty, kebabCase, loadImage, logError, looseToNumber, lowerFirst, lunarDayNames, lunarInfo, lunarMonthNames, lunarToSolar, lunarYearNames, mapTreeToGrid, matchScrollVisible, measureTextWidth, minmaxDate, mround, nestedToMulti, noop, normalizeBarcodeOptions, normalizeHsla, normalizeHsva, omit, parseColor, parseDate, partition, pascalCase, pick, qrcode, random, readFileContent, rgbToHsl, round, scrollToTarget, setCheckedRecursively, shuffle, sleep, snakeCase, solarToLunar, splitUnit, spreadEach, springFestivals, throttle, toArray, toDate, toDateNumber, toDateString, toMonthNumber, toTouchEvent, treeToMap, truncToFixed, uniqid, updateAncestorsChecked, upperFirst, useScroller, walkAncestor, walkDescendant, walkNodes, withResolvers };
+export { ALPHANUMERIC_CHARS, BarcodeFormatList, BarcodeTextPositionList, ECLList, Friction, Spring, addSeparator, addUnit, arrayEqual, arrayMove, assignDeep, barcode, baseLunarYear, calculateBarcodeLayout, camelCase, capitalize, chainGet, chainSet, checkRtl, chooseFile, clamp, clipboard, compactNumber, createBem, createBemStruct, createInertialAnimate, cssVar, cssVarName, debounce, deepClone, defaultBemConfig, defaultColorPickerPresets, defaultColorPickerValue, defineSetupFnComponent, earthlyBranches, enhanceComponent, extend, formatColor, formatDate, formatNumber, formatThousands, getAspectFillSize, getAspectFitSize, getDampingValue, getDayOfYear, getDaysAfterLastDay, getDaysBeforeFirstDay, getDaysInMonth, getDaysSinceUnixEpoch, getDecimalsLength, getFileName, getFirstDayWeekday, getInBoundValue, getLeafNodes, getLunarDayName, getLunarHourName, getLunarLeapMonth, getLunarLeapMonthDays, getLunarMonthDays, getLunarMonthName, getLunarYearDays, getLunarYearName, getNextMonthDate, getNextMonthHeadDays, getNodeLevel, getOverflowRangeInArea, getPageRange, getPrevMonthDate, getPrevMonthTailDays, getPreviewColor, getRectDampingValue, getRotatedRect, getScrollIntoViewValue, getScrollTop, getTouchPoint, getTransformOrigin, getTreeCheckedKeys, getTreeHalfCheckedKeys, getTwoPointsDistance, heavenlyStems, hslToHsv, hslToHwb, hslToRgb, hsvToHsl, hwbToHsl, imageDataToDataURL, inRange, initializeCheckNodes, interpolate, isBoolean, isConfigObject, isDate, isEmptyArray, isEmptyBinding, isEmptyValue, isFileUrl, isFunction, isImageFile, isImageUrl, isKorean, isLeapYear, isNoEmptyArray, isNullish, isNumber, isObject, isPlainObject, isPrimitive, isRectEqual, isRenderVisible, isSizeEqual, isString, isUndefined, isVideoFile, isVideoUrl, isVisibleEmpty, kebabCase, loadImage, logError, looseToNumber, lowerFirst, lunarDayNames, lunarInfo, lunarMonthNames, lunarToSolar, lunarYearNames, mapTreeToGrid, matchScrollVisible, measureTextWidth, minmaxDate, mround, nestedToMulti, noop, normalizeBarcodeOptions, normalizeHsla, normalizeHsva, omit, parseColor, parseDate, partition, pascalCase, pick, qrcode, random, readFileContent, rgbToHsl, round, scrollToTarget, setCheckedRecursively, shuffle, sleep, snakeCase, solarToLunar, splitUnit, spreadEach, springFestivals, throttle, toArray, toDate, toDateNumber, toDateString, toMonthNumber, toTouchEvent, treeToMap, truncToFixed, uniqid, updateAncestorsChecked, upperFirst, useScroller, walkAncestor, walkDescendant, walkNodes, withResolvers };

package/utils/is.d.ts

@@ -73,7 +73,10 @@ export declare function isPrimitive(target: any): target is string | number | bo
  */
 export declare function isDate(target: any): target is Date;
 /**
- * 判断是否为配置对象（而非 VNode）
+ * 判断是否为配置对象（而非其他类型的值）
+ *
+ * NOTE: 这里不再用 `isVNode` 排除 VNode —— `message` 之类的内容按文本渲染，
+ * 传 VNode 本来就没有意义，且 vapor 下不存在 VNode。
  * @param {any} target
  * @return {boolean}
  */

package/utils/is.js

@@ -1,4 +1,3 @@
-import { isVNode } from "vue";
 //#region packages/sard/utils/is.ts
 /**
 * @description: 判断是否为纯对象
@@ -97,12 +96,15 @@ function isDate(target) {
 	return target instanceof Date;
 }
 /**
-* 判断是否为配置对象（而非 VNode）
+* 判断是否为配置对象（而非其他类型的值）
+*
+* NOTE: 这里不再用 `isVNode` 排除 VNode —— `message` 之类的内容按文本渲染，
+* 传 VNode 本来就没有意义，且 vapor 下不存在 VNode。
 * @param {any} target
 * @return {boolean}
 */
 function isConfigObject(target) {
-	return isPlainObject(target) && !isVNode(target);
+	return isPlainObject(target);
 }
 //#endregion
 export { isBoolean, isConfigObject, isDate, isEmptyArray, isFunction, isNoEmptyArray, isNullish, isNumber, isObject, isPlainObject, isPrimitive, isString, isUndefined };

package/utils/number.d.ts

@@ -42,7 +42,7 @@ export declare function truncToFixed(num: number, decimals?: number): string;
  * @param decimals 小数位数
  * @param keepZero 是否保留为0时的小数部分
  */
-export declare function compactNumber(num: number | string, decimals?: number, keepZero?: boolean): string;
+export declare function compactNumber(num: number | string | null | undefined, decimals?: number, keepZero?: boolean): string;
 /**
  * 将数字格式化为千分位格式
  * @param  num

package/utils/number.js

@@ -1,3 +1,4 @@
+import { isNumber } from "./is.js";
 //#region packages/sard/utils/number.ts
 /**
 * 限定数值范围
@@ -67,6 +68,24 @@ function truncToFixed(num, decimals = 0) {
 	const n = Math.pow(10, decimals);
 	return (Math.trunc(num * n) / n).toFixed(decimals);
 }
+const units = [
+	{
+		value: 0xe8d4a51000,
+		symbol: "T"
+	},
+	{
+		value: 1e9,
+		symbol: "B"
+	},
+	{
+		value: 1e6,
+		symbol: "M"
+	},
+	{
+		value: 1e3,
+		symbol: "K"
+	}
+];
 /**
 * 通过添加单位缩写数字
 * @param num
@@ -75,25 +94,7 @@ function truncToFixed(num, decimals = 0) {
 */
 function compactNumber(num, decimals = 1, keepZero = false) {
 	num = typeof num === "string" ? Number.parseFloat(num) : num;
-	if (!Number.isFinite(num)) return "0";
-	const units = [
-		{
-			value: 0xe8d4a51000,
-			symbol: "T"
-		},
-		{
-			value: 1e9,
-			symbol: "B"
-		},
-		{
-			value: 1e6,
-			symbol: "M"
-		},
-		{
-			value: 1e3,
-			symbol: "K"
-		}
-	];
+	if (!isNumber(num) || !Number.isFinite(num)) return "0";
 	const isNegative = num < 0;
 	if (isNegative) num = Math.abs(num);
 	let formattedNum = truncToFixed(num, decimals);

package/components/picker-view/picker-view-column.d.ts

@@ -1,3 +0,0 @@
-import { type PickerViewColumnSlots } from './common';
-declare const _default: import("vue").DefineSetupFnComponent<import("vue").ExtractPublicPropTypes<unknown>, {}, PickerViewColumnSlots>;
-export default _default;

package/components/picker-view/picker-view-column.js

@@ -1,139 +0,0 @@
-import { createBem } from "../../utils/bem.js";
-import { flatVNode } from "../../utils/vnode.js";
-import { defineSetupFnComponent } from "../../utils/component.js";
-import { Friction } from "../../utils/scroller/Friction.js";
-import { Spring } from "../../utils/scroller/Spring.js";
-import { usePointerDown } from "../../use/usePointerDown.js";
-import { useResizeObserver } from "../../use/useResizeObserver.js";
-import { useScroller } from "../../utils/scroller/useScroller.js";
-import { pickerViewContextKey } from "./common.js";
-import { computed, createVNode, getCurrentInstance, inject, ref, watch, watchPostEffect } from "vue";
-//#region packages/sard/components/picker-view/picker-view-column.tsx
-var picker_view_column_default = defineSetupFnComponent((_props, { slots }) => {
-	const bem = createBem("picker-view-column");
-	const instance = getCurrentInstance();
-	const rootRef = ref(null);
-	const contentRef = ref(null);
-	const indicatorRef = ref(null);
-	const context = inject(pickerViewContextKey);
-	const columnValue = context.getColumnValue(instance);
-	const itemCount = ref(0);
-	const rootSize = useResizeObserver(rootRef);
-	const contentSize = useResizeObserver(contentRef);
-	const indicatorSize = useResizeObserver(indicatorRef);
-	const maskSize = computed(() => (rootSize.height - indicatorSize.height) / 2);
-	const contentHeight = computed(() => {
-		return contentSize.height + maskSize.value * 2;
-	});
-	const { position, update, scrollTo, isIdle, handleTouchStart, handleTouchMove, handleTouchEnd } = useScroller({
-		itemSize: indicatorSize.height,
-		friction: new Friction(1e-4),
-		spring: new Spring(2, 90, 20),
-		onSnap: (index) => {
-			if (!isNaN(index) && index !== columnValue.value) columnValue.value = index;
-		},
-		onTap: (event) => {
-			handleTap(event);
-		}
-	});
-	let updatePending = false;
-	watch([
-		() => indicatorSize.height,
-		columnValue,
-		itemCount,
-		() => rootSize.height,
-		contentHeight
-	], () => {
-		if (updatePending) return;
-		updatePending = true;
-		setTimeout(() => {
-			updatePending = false;
-			if (indicatorSize.height) {
-				const current = Math.max(Math.min(columnValue.value, itemCount.value - 1), 0);
-				update(current * indicatorSize.height, indicatorSize.height, rootSize.height, contentHeight.value);
-			}
-		});
-	}, { flush: "post" });
-	watchPostEffect(() => {
-		const el = contentRef.value;
-		if (!el) return;
-		const transform = "translateY(" + position.value + "px) translateZ(0)";
-		el.style.transform = transform;
-	});
-	let oldDeltaY = 0;
-	function handleWheel(event) {
-		const deltaY = oldDeltaY + event.deltaY;
-		if (Math.abs(deltaY) > 10) {
-			oldDeltaY = 0;
-			let current = Math.min(columnValue.value + (deltaY < 0 ? -1 : 1), itemCount.value - 1);
-			columnValue.value = current = Math.max(current, 0);
-			scrollTo(current * indicatorSize.height);
-		} else oldDeltaY = deltaY;
-		event.preventDefault();
-	}
-	function handleTap({ changedTouches: [{ clientY }] }) {
-		const el = rootRef.value;
-		if (isIdle()) {
-			const r = clientY - el.getBoundingClientRect().top - rootSize.height / 2;
-			const o = indicatorSize.height / 2;
-			if (!(Math.abs(r) <= o)) {
-				const a = Math.ceil((Math.abs(r) - o) / indicatorSize.height);
-				const s = r < 0 ? -a : a;
-				let current = Math.min(columnValue.value + s, itemCount.value - 1);
-				columnValue.value = current = Math.max(current, 0);
-				scrollTo(current * indicatorSize.height);
-			}
-		}
-	}
-	const onTouchStart = (event) => {
-		handleTouchStart(event);
-	};
-	const onTouchMove = (event) => {
-		handleTouchMove(event);
-		event.stopPropagation();
-	};
-	const onTouchEnd = (event) => {
-		handleTouchEnd(event);
-	};
-	const onPointerDown = usePointerDown(onTouchStart, onTouchMove, onTouchEnd);
-	return () => {
-		const defaultSlots = slots.default?.();
-		itemCount.value = flatVNode(defaultSlots).length;
-		const padding = `${maskSize.value}px 0`;
-		return createVNode("div", {
-			"ref": rootRef,
-			"class": bem.b(),
-			"onTouchstart": onTouchStart,
-			"onTouchmove": onTouchMove,
-			"onTouchend": onTouchEnd,
-			"onTouchcancel": onTouchEnd,
-			"onPointerdown": onPointerDown
-		}, [createVNode("div", {
-			"class": bem.e("group"),
-			"onWheel": handleWheel
-		}, [
-			createVNode("div", {
-				"class": [bem.e("mask"), context.maskClass],
-				"style": [`background-size: 100% ${maskSize.value}px;`, context.maskStyle]
-			}, null),
-			createVNode("div", {
-				"ref": indicatorRef,
-				"class": [bem.e("indicator"), context.indicatorClass],
-				"style": context.indicatorStyle
-			}, null),
-			createVNode("div", {
-				"ref": contentRef,
-				"class": [bem.e("content")],
-				"style": {
-					padding,
-					"--picker-view-indicator-height": `${indicatorSize.height}px`
-				}
-			}, [defaultSlots])
-		])]);
-	};
-}, {
-	name: "PickerViewColumn",
-	slots: null
-});
-//#endregion
-export { picker_view_column_default as default };

package/components/picker-view/picker-view.d.ts

@@ -1,21 +0,0 @@
-import { type PickerViewEmits, type PickerViewSlots } from './common';
-declare const _default: import("vue").DefineSetupFnComponent<import("vue").ExtractPublicPropTypes<{
-    value: {
-        type: import("vue").PropType<number[]>;
-        default(): never[];
-        validator(val: any): boolean;
-    };
-    indicatorStyle: {
-        type: import("vue").PropType<import("vue").StyleValue>;
-    };
-    indicatorClass: {
-        type: import("vue").PropType<import("vue").ClassValue>;
-    };
-    maskStyle: {
-        type: import("vue").PropType<import("vue").StyleValue>;
-    };
-    maskClass: {
-        type: import("vue").PropType<import("vue").ClassValue>;
-    };
-}>, PickerViewEmits, PickerViewSlots>;
-export default _default;

package/components/picker-view/picker-view.js

@@ -1,57 +0,0 @@
-import { createBem } from "../../utils/bem.js";
-import { flatVNode } from "../../utils/vnode.js";
-import { defineSetupFnComponent } from "../../utils/component.js";
-import { pickerViewContextKey, pickerViewProps } from "./common.js";
-import { computed, createVNode, provide, reactive, ref, toRef, watch } from "vue";
-//#region packages/sard/components/picker-view/picker-view.tsx
-var picker_view_default = defineSetupFnComponent((props, { slots, emit }) => {
-	const bem = createBem("picker-view");
-	const innerValue = reactive([...props.value]);
-	watch(() => props.value, (value) => {
-		innerValue.length = value.length;
-		value.forEach((val, index) => {
-			if (val !== innerValue[index]) innerValue.splice(index, 1, val);
-		});
-	});
-	const columnsRef = ref([]);
-	function getItemIndex(vnode) {
-		return columnsRef.value.indexOf(vnode);
-	}
-	const getColumnValue = (columnInstance) => {
-		return computed({
-			get() {
-				const index = getItemIndex(columnInstance.vnode);
-				return innerValue[index] || 0;
-			},
-			set(current) {
-				const index = getItemIndex(columnInstance.vnode);
-				if (index < 0) return;
-				if (innerValue[index] !== current) {
-					innerValue[index] = current;
-					const value = [...innerValue];
-					emit("update:value", value);
-					emit("change", value);
-				}
-			}
-		});
-	};
-	provide(pickerViewContextKey, reactive({
-		maskStyle: toRef(() => props.maskStyle),
-		maskClass: toRef(() => props.maskClass),
-		indicatorClass: toRef(() => props.indicatorClass),
-		indicatorStyle: toRef(() => props.indicatorStyle),
-		getColumnValue
-	}));
-	return () => {
-		const defaultSlots = slots.default && slots.default();
-		columnsRef.value = flatVNode(defaultSlots);
-		return createVNode("div", { "class": bem.b() }, [createVNode("div", { "class": bem.e("wrapper") }, [defaultSlots])]);
-	};
-}, {
-	name: "PickerView",
-	props: pickerViewProps,
-	emits: ["change", "update:value"],
-	slots: null
-});
-//#endregion
-export { picker_view_default as default };

package/components/swiper/swiper-item.d.ts

@@ -1,3 +0,0 @@
-import { type SwiperItemSlots } from './common';
-declare const _default: import("vue").DefineSetupFnComponent<import("vue").ExtractPublicPropTypes<{}>, {}, SwiperItemSlots>;
-export default _default;