@zboson/ui 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Antdv Next
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,105 @@
-# Temporary Holding Version
+<div align="center"><a name="readme-top"></a>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<img height="180" src="https://www.antdv-next.com/assets/antdv-next-Cum7m2ZU.svg">
+
+<h1>Antdv Next</h1>
+
+Antdv Next is a Vue 3 enterprise component library built on the Ant Design design system.
+
+[![CI status][github-action-image]][github-action-url]
+[![codecov][codecov-image]][codecov-url]
+[![NPM version][npm-image]][npm-url]
+[![NPM downloads][download-image]][download-url]
+[![][jsdelivr-image]][jsdelivr-url]
+[![][nuxt-image]][nuxt-url]
+
+English · [中文](./README.zh-CN.md)
+
+## ❤️ Sponsors
+
+| <a href="https://ergouzi.life/register?utm_source=antdv-next"><img src="https://nzj13gqqmj.ufs.sh/f/7vCb7ZuKZQXM8I2IHQXhPqNEAXV4gJm0LzopUFvck3bCKG1e" width="80" alt="二狗子中转"></a> | <a href="https://penna.pro"><img src="https://penna.pro/logo.svg" width="80" alt="Penna Note"></a> | <a href="https://jeesite.com/?utm_source=antdv-next"><img src="https://jeesite.com/assets/images/logo.png" width="80" alt="JeeSite 低代码"></a> |
+| :-: | :-: | :-: |
+
+</div>
+
+## ✨ Features
+
+- 🌈 Enterprise-class UI designed for web applications.
+- 📦 A set of high-quality Vue3 components out of the box.
+- 🛡 Written in TypeScript with predictable static types.
+- ⚙️ Whole package of design resources and development tools.
+- 🌍 Internationalization support for dozens of languages.
+- 🎨 Powerful theme customization based on CSS-in-JS.
+
+## 🖥 Environment Support
+
+- Modern browsers
+- Server-side Rendering
+- [Electron](https://www.electronjs.org/)
+
+| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt="Edge" width="24px" height="24px" /><br>Edge](https://godban.github.io/browsers-support-badges/) | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" /><br>Firefox](https://godban.github.io/browsers-support-badges/) | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" /><br>Chrome](https://godban.github.io/browsers-support-badges/) | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" /><br>Safari](https://godban.github.io/browsers-support-badges/) | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/electron/electron_48x48.png" alt="Electron" width="24px" height="24px" /><br>Electron](https://godban.github.io/browsers-support-badges/) |
+| --- | --- | --- | --- | --- |
+| last 2 versions | last 2 versions | last 2 versions | last 2 versions | last 2 versions |
+
+## 📦 Install
+
+```bash
+npm install @zboson/ui
+```
+
+```bash
+yarn add @zboson/ui
+```
+
+```bash
+pnpm add @zboson/ui
+```
+
+```bash
+bun add @zboson/ui
+```
+
+## ✅ Unit Test Coverage
+
+- Run coverage locally: `pnpm test:coverage`
+- Coverage output directory: `coverage/`
+- On GitHub Release publish (`release.published`), CI runs unit tests with coverage and uploads the `coverage/` artifact via the `Unit Test Upload` workflow.
+
+## Acknowledgements
+
+Antdv Next is inspired by and built upon the following open-source projects.
+
+- [Ant Design](https://ant.design/)
+- [Vue.js](https://vuejs.org/)
+- [Vite](https://vitejs.dev/)
+
+## Contribute
+
+We warmly welcome you to participate in our open source project.
+
+**Pull Request:**
+
+1. Fork the repository.
+2. Create your own branch: `git checkout -b feat-xxxx`.
+3. Commit your changes: `git commit -am 'feat(function): add xxxxx'`.
+4. Push your branch: `git push origin feat-xxxx`.
+5. Submit a pull request.
+
+Thank you to all the people who already contributed to Antdv Next!
+
+<a href="https://github.com/antdv-next/antdv-next/graphs/contributors">
+  <img src="https://opencollective.com/antdv-next/contributors.svg?width=890&limit=500" />
+</a>
+
+[github-action-image]: https://github.com/antdv-next/antdv-next/actions/workflows/test.yml/badge.svg
+[github-action-url]: https://github.com/antdv-next/antdv-next/actions/workflows/test.yml
+[codecov-image]: https://img.shields.io/codecov/c/github/antdv-next/antdv-next?style=flat-square
+[codecov-url]: https://codecov.io/gh/antdv-next/antdv-next
+[npm-image]: https://img.shields.io/npm/v/@zboson/ui.svg?style=flat-square
+[npm-url]: https://www.npmjs.com/package/@zboson/ui
+[download-image]: https://img.shields.io/npm/dm/@zboson/ui.svg?style=flat-square
+[download-url]: https://www.npmjs.com/package/@zboson/ui
+[jsdelivr-image]: https://data.jsdelivr.com/v1/package/npm/@zboson/ui/badge
+[jsdelivr-url]: https://www.jsdelivr.com/package/npm/@zboson/ui
+[nuxt-image]: https://img.shields.io/badge/Nuxt-supported-00DC82?style=flat-square&logo=nuxtdotjs&logoColor=white
+[nuxt-url]: https://nuxt.com/

package/dist/_util/ActionButton.d.ts

@@ -0,0 +1,23 @@
+import { EmptyEmit } from "./type.js";
+import { ButtonProps, LegacyButtonType } from "../button/Button.js";
+import "../button/index.js";
+import { SlotsType } from "vue";
+//#region src/_util/ActionButton.d.ts
+interface ActionButtonProps {
+  type?: LegacyButtonType;
+  actionFn?: (...args: any[]) => any | PromiseLike<any>;
+  close?: (...args: any[]) => void;
+  autoFocus?: boolean;
+  prefixCls: string;
+  buttonProps?: ButtonProps;
+  emitEvent?: boolean;
+  quitOnNullishReturnValue?: boolean;
+  children?: any;
+  isSilent?: () => boolean;
+}
+interface ActionButtonSlots {
+  default?: () => any;
+}
+declare const ActionButton: import("vue").DefineSetupFnComponent<ActionButtonProps, EmptyEmit, SlotsType<ActionButtonSlots>, ActionButtonProps, import("vue").PublicProps>;
+//#endregion
+export { ActionButtonProps, ActionButtonSlots, ActionButton as default };

package/dist/_util/ActionButton.js

@@ -0,0 +1,129 @@
+import { convertLegacyProps } from "../button/Button.js";
+import button_default from "../button/index.js";
+import { createVNode, defineComponent, mergeProps, onBeforeUnmount, onMounted, shallowRef } from "vue";
+//#region src/_util/ActionButton.tsx
+function isThenable(value) {
+	return typeof value?.then === "function";
+}
+const ActionButton = /* @__PURE__ */ defineComponent((props, { slots }) => {
+	const clicked = shallowRef(false);
+	const loading = shallowRef(false);
+	const buttonRef = shallowRef();
+	let autoFocusTimeout = null;
+	const focusButton = () => {
+		const instance = buttonRef.value;
+		(instance?.$el ?? instance)?.focus?.({ preventScroll: true });
+	};
+	onMounted(() => {
+		if (props.autoFocus) autoFocusTimeout = setTimeout(() => {
+			focusButton();
+		});
+	});
+	onBeforeUnmount(() => {
+		if (autoFocusTimeout) {
+			clearTimeout(autoFocusTimeout);
+			autoFocusTimeout = null;
+		}
+	});
+	const onInternalClose = (...args) => {
+		props.close?.(...args);
+	};
+	const handlePromiseOnOk = (returnValueOfOnOk) => {
+		if (!isThenable(returnValueOfOnOk)) return;
+		loading.value = true;
+		returnValueOfOnOk.then((...args) => {
+			loading.value = false;
+			clicked.value = false;
+			onInternalClose(...args);
+		}, (error) => {
+			loading.value = false;
+			clicked.value = false;
+			if (props.isSilent?.()) return;
+			return Promise.reject(error);
+		});
+	};
+	const onClick = (e) => {
+		if (clicked.value) return;
+		clicked.value = true;
+		const { actionFn } = props;
+		if (!actionFn) {
+			onInternalClose();
+			return;
+		}
+		let returnValueOfOnOk;
+		if (props.emitEvent) {
+			returnValueOfOnOk = actionFn(e);
+			if (props.quitOnNullishReturnValue && !isThenable(returnValueOfOnOk)) {
+				clicked.value = false;
+				onInternalClose(e);
+				return;
+			}
+		} else if (actionFn.length) {
+			returnValueOfOnOk = actionFn(onInternalClose);
+			clicked.value = false;
+		} else {
+			returnValueOfOnOk = actionFn();
+			if (!isThenable(returnValueOfOnOk)) {
+				onInternalClose();
+				return;
+			}
+		}
+		handlePromiseOnOk(returnValueOfOnOk);
+	};
+	return () => {
+		const buttonAttrs = props.buttonProps ?? {};
+		return createVNode(button_default, mergeProps(convertLegacyProps(props.type), {
+			"prefixCls": props.prefixCls,
+			"loading": loading.value,
+			"ref": buttonRef,
+			"onClick": onClick
+		}, buttonAttrs), { default: () => [slots.default?.()] });
+	};
+}, {
+	props: {
+		type: {
+			type: String,
+			required: false
+		},
+		actionFn: {
+			type: Function,
+			required: false
+		},
+		close: {
+			type: Function,
+			required: false
+		},
+		autoFocus: {
+			type: Boolean,
+			required: false,
+			default: void 0
+		},
+		prefixCls: {
+			type: String,
+			required: true
+		},
+		buttonProps: {
+			type: Object,
+			required: false
+		},
+		emitEvent: {
+			type: Boolean,
+			required: false,
+			default: void 0
+		},
+		quitOnNullishReturnValue: {
+			type: Boolean,
+			required: false,
+			default: void 0
+		},
+		children: { required: false },
+		isSilent: {
+			type: Function,
+			required: false
+		}
+	},
+	name: "AActionButton",
+	inheritAttrs: false
+});
+//#endregion
+export { ActionButton as default };

package/dist/_util/ContextIsolator.d.ts

@@ -0,0 +1,10 @@
+//#region src/_util/ContextIsolator.d.ts
+declare const ContextIsolator: import("vue").DefineSetupFnComponent<{
+  space?: boolean;
+  form?: boolean;
+}, {}, {}, {
+  space?: boolean;
+  form?: boolean;
+} & {}, import("vue").PublicProps>;
+//#endregion
+export { ContextIsolator };

package/dist/_util/ContextIsolator.js

@@ -0,0 +1,45 @@
+import { NoFormStyle } from "../form/context.js";
+import { NoCompactStyle } from "../space/Compact.js";
+import { createVNode, defineComponent, isVNode } from "vue";
+import { filterEmpty } from "@v-c/util/dist/props-util";
+//#region src/_util/ContextIsolator.tsx
+function _isSlot(s) {
+	return typeof s === "function" || Object.prototype.toString.call(s) === "[object Object]" && !isVNode(s);
+}
+const ContextIsolator = /* @__PURE__ */ defineComponent((props, { slots }) => {
+	return () => {
+		const { space, form } = props;
+		const children = filterEmpty(slots?.default?.());
+		if (children.length === 0) return null;
+		let result = children;
+		if (form) {
+			const _result = function() {
+				return result;
+			}();
+			result = createVNode(NoFormStyle, {
+				"override": true,
+				"status": true
+			}, _isSlot(result) ? result : { default: () => [_result] });
+		}
+		if (space) {
+			const _result2 = function() {
+				return result;
+			}();
+			result = createVNode(NoCompactStyle, null, _isSlot(result) ? result : { default: () => [_result2] });
+		}
+		return result;
+	};
+}, { props: {
+	space: {
+		type: Boolean,
+		required: false,
+		default: void 0
+	},
+	form: {
+		type: Boolean,
+		required: false,
+		default: void 0
+	}
+} });
+//#endregion
+export { ContextIsolator };

package/dist/_util/PurePanel.d.ts

@@ -0,0 +1,11 @@
+import { CSSProperties } from "vue";
+//#region src/_util/PurePanel.d.ts
+interface BaseProps {
+  prefixCls?: string;
+  style?: CSSProperties;
+  open?: boolean;
+}
+declare function withPureRenderTheme(Component: any): (props: any) => import("vue/jsx-runtime").JSX.Element;
+declare function genPurePanel(Component: any, alignPropName?: 'align' | 'dropdownAlign' | 'popupAlign', postProps?: (props: any) => any, defaultPrefixCls?: string, getDropdownCls?: (prefixCls: string) => string): (props: any) => import("vue/jsx-runtime").JSX.Element;
+//#endregion
+export { BaseProps, genPurePanel as default, withPureRenderTheme };

package/dist/_util/PurePanel.js

@@ -0,0 +1,105 @@
+import { useBaseConfig } from "../config-provider/context.js";
+import { normalizeStyle as normalizeStyle$1 } from "./styleUtils.js";
+import ConfigProvider from "../config-provider/index.js";
+import { createVNode, defineComponent, mergeProps, shallowRef, useAttrs, useSlots, watch } from "vue";
+//#region src/_util/PurePanel.tsx
+function withPureRenderTheme(Component) {
+	return (props) => {
+		const slots = useSlots();
+		const attrs = useAttrs();
+		return createVNode(ConfigProvider, { "theme": { token: {
+			motion: false,
+			zIndexPopupBase: 0
+		} } }, { default: () => [createVNode(Component, {
+			...props,
+			...attrs
+		}, slots)] });
+	};
+}
+/* istanbul ignore next */
+function genPurePanel(Component, alignPropName, postProps, defaultPrefixCls, getDropdownCls) {
+	return withPureRenderTheme(/* @__PURE__ */ defineComponent((props, { slots, attrs }) => {
+		const holderRef = shallowRef();
+		const popupHeight = shallowRef(0);
+		const popupWidth = shallowRef(0);
+		const open = shallowRef(props?.open ?? false);
+		const setOpen = (value) => {
+			if (props.open !== void 0) return;
+			open.value = value;
+		};
+		watch(() => props.open, () => {
+			open.value = props.open ?? false;
+		});
+		const { prefixCls } = useBaseConfig(defaultPrefixCls ?? "select", props);
+		watch(prefixCls, (_, _o, onCleanup) => {
+			setOpen(true);
+			if (typeof ResizeObserver !== "undefined") {
+				const resizeObserver = new ResizeObserver((entries) => {
+					const element = entries[0].target;
+					popupHeight.value = element.offsetHeight + 8;
+					popupWidth.value = element.offsetWidth;
+				});
+				const interval = setInterval(() => {
+					const dropdownCls = getDropdownCls ? `.${getDropdownCls(prefixCls.value)}` : `.${prefixCls.value}-dropdown`;
+					const popup = holderRef.value?.querySelector(dropdownCls);
+					if (popup) {
+						clearInterval(interval);
+						resizeObserver.observe(popup);
+					}
+				}, 10);
+				onCleanup(() => {
+					clearInterval(interval);
+					resizeObserver.disconnect();
+				});
+			}
+		}, {
+			immediate: true,
+			flush: "post"
+		});
+		return () => {
+			const { style } = props;
+			let mergedProps = {
+				...props,
+				style: {
+					...normalizeStyle$1(style) || {},
+					margin: 0
+				},
+				open: open.value,
+				getPopupContainer: () => holderRef.value
+			};
+			if (postProps) mergedProps = postProps(mergedProps);
+			if (alignPropName) Object.assign(mergedProps, { [alignPropName]: { overflow: {
+				adjustX: false,
+				adjustY: false
+			} } });
+			const mergedStyle = {
+				paddingBottom: `${popupHeight.value}px`,
+				position: "relative",
+				minWidth: `${popupWidth.value}px`
+			};
+			return createVNode("div", {
+				"ref": holderRef,
+				"style": mergedStyle
+			}, [createVNode(Component, mergeProps(attrs, mergedProps), slots)]);
+		};
+	}, {
+		props: {
+			prefixCls: {
+				type: String,
+				required: false
+			},
+			style: {
+				type: Object,
+				required: false
+			},
+			open: {
+				type: Boolean,
+				required: false,
+				default: void 0
+			}
+		},
+		inheritAttrs: false
+	}));
+}
+//#endregion
+export { genPurePanel as default, withPureRenderTheme };

package/dist/_util/aria-data-attrs.d.ts

@@ -0,0 +1,7 @@
+import { AriaAttributes } from "vue";
+//#region src/_util/aria-data-attrs.d.ts
+type HTMLAriaDataAttributes = AriaAttributes & {
+  [key: `data-${string}`]: unknown;
+} & Pick<HTMLDivElement, 'role'>;
+//#endregion
+export { HTMLAriaDataAttributes };

package/dist/_util/aria-data-attrs.js

@@ -0,0 +1 @@
+export {};

package/dist/_util/capitalize.d.ts

@@ -0,0 +1,4 @@
+//#region src/_util/capitalize.d.ts
+declare function capitalize<T extends string>(str: T): Capitalize<T>;
+//#endregion
+export { capitalize as default };

package/dist/_util/capitalize.js

@@ -0,0 +1,7 @@
+//#region src/_util/capitalize.ts
+function capitalize(str) {
+	if (typeof str !== "string") return str;
+	return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//#endregion
+export { capitalize as default };

package/dist/_util/colors.d.ts

@@ -0,0 +1,16 @@
+import { PresetColorKey } from "../theme/interface/presetColors.js";
+import "../theme/interface/index.js";
+//#region src/_util/colors.d.ts
+type InverseColor = `${PresetColorKey}-inverse`;
+declare const PresetStatusColorTypes: readonly ["success", "processing", "error", "default", "warning"];
+type PresetColorType = PresetColorKey | InverseColor;
+type PresetStatusColorType = (typeof PresetStatusColorTypes)[number];
+/**
+ * determine if the color keyword belongs to the `Ant Design` {@link PresetColors}.
+ * @param color color to be judged
+ * @param includeInverse whether to include reversed colors
+ */
+declare function isPresetColor(color?: any, includeInverse?: boolean): boolean;
+declare function isPresetStatusColor(color?: any): color is PresetStatusColorType;
+//#endregion
+export { PresetColorType, PresetStatusColorType, PresetStatusColorTypes, isPresetColor, isPresetStatusColor };

package/dist/_util/colors.js

@@ -0,0 +1,24 @@
+import { PresetColors } from "../theme/interface/presetColors.js";
+//#region src/_util/colors.ts
+const inverseColors = PresetColors.map((color) => `${color}-inverse`);
+const PresetStatusColorTypes = [
+	"success",
+	"processing",
+	"error",
+	"default",
+	"warning"
+];
+/**
+* determine if the color keyword belongs to the `Ant Design` {@link PresetColors}.
+* @param color color to be judged
+* @param includeInverse whether to include reversed colors
+*/
+function isPresetColor(color, includeInverse = true) {
+	if (includeInverse) return [...inverseColors, ...PresetColors].includes(color);
+	return PresetColors.includes(color);
+}
+function isPresetStatusColor(color) {
+	return PresetStatusColorTypes.includes(color);
+}
+//#endregion
+export { PresetStatusColorTypes, isPresetColor, isPresetStatusColor };

package/dist/_util/convertToTooltipProps.d.ts

@@ -0,0 +1,6 @@
+import { VueNode } from "./type.js";
+import { TooltipProps } from "../tooltip/index.js";
+//#region src/_util/convertToTooltipProps.d.ts
+declare function convertToTooltipProps<P extends TooltipProps>(tooltip?: P | VueNode, context?: P): P | null;
+//#endregion
+export { convertToTooltipProps as default };

package/dist/_util/convertToTooltipProps.js

@@ -0,0 +1,15 @@
+import { isVNode } from "vue";
+//#region src/_util/convertToTooltipProps.ts
+function convertToTooltipProps(tooltip, context) {
+	if (tooltip === void 0 || tooltip === null) return null;
+	if (typeof tooltip === "object" && !Array.isArray(tooltip) && !isVNode(tooltip)) return {
+		...context,
+		...tooltip
+	};
+	return {
+		...context,
+		title: tooltip
+	};
+}
+//#endregion
+export { convertToTooltipProps as default };

package/dist/_util/copy.d.ts

@@ -0,0 +1,6 @@
+//#region src/_util/copy.d.ts
+declare function copy(text: string, config?: {
+  format?: 'text/plain' | 'text/html';
+}): Promise<boolean>;
+//#endregion
+export { copy as default };

package/dist/_util/copy.js

@@ -0,0 +1,46 @@
+import warning from "./warning.js";
+//#region src/_util/copy.ts
+function execCopy(text, isHtmlFormat) {
+	let copySuccess = false;
+	const onCopy = (event) => {
+		event.stopPropagation();
+		event.preventDefault();
+		event.clipboardData?.clearData();
+		event.clipboardData?.setData("text/plain", text);
+		if (isHtmlFormat) event.clipboardData?.setData("text/html", text);
+		copySuccess = true;
+	};
+	try {
+		document.addEventListener("copy", onCopy, { capture: true });
+		document.execCommand("copy");
+		return copySuccess;
+	} catch {
+		return false;
+	} finally {
+		document.removeEventListener("copy", onCopy, { capture: true });
+	}
+}
+async function asyncCopy(text, isHtmlFormat) {
+	try {
+		if (isHtmlFormat) await navigator.clipboard.write([new ClipboardItem({
+			"text/html": new Blob([text], { type: "text/html" }),
+			"text/plain": new Blob([text], { type: "text/plain" })
+		})]);
+		else await navigator.clipboard.writeText(text);
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function copy(text, config) {
+	if (typeof text !== "string") {
+		warning(false, "clipboard", "The clipboard content must be of string type");
+		return false;
+	}
+	const isHtmlFormat = config?.format === "text/html";
+	if (await asyncCopy(text, isHtmlFormat)) return true;
+	if (execCopy(text, isHtmlFormat)) return true;
+	return false;
+}
+//#endregion
+export { copy as default };

package/dist/_util/easings.d.ts

@@ -0,0 +1,4 @@
+//#region src/_util/easings.d.ts
+declare function easeInOutCubic(t: number, b: number, c: number, d: number): number;
+//#endregion
+export { easeInOutCubic };

package/dist/_util/easings.js

@@ -0,0 +1,9 @@
+//#region src/_util/easings.ts
+function easeInOutCubic(t, b, c, d) {
+	const cc = c - b;
+	t /= d / 2;
+	if (t < 1) return cc / 2 * t * t * t + b;
+	return cc / 2 * ((t -= 2) * t * t + 2) + b;
+}
+//#endregion
+export { easeInOutCubic };

package/dist/_util/extendsObject.d.ts

@@ -0,0 +1,6 @@
+//#region src/_util/extendsObject.d.ts
+declare function mergeProps<A, B>(a: A, b: B): B & A;
+declare function mergeProps<A, B, C>(a: A, b: B, c: C): C & B & A;
+declare function mergeProps<A, B, C, D>(a: A, b: B, c: C, d: D): D & C & B & A;
+//#endregion
+export { mergeProps as default };

package/dist/_util/extendsObject.js

@@ -0,0 +1,12 @@
+//#region src/_util/extendsObject.ts
+function mergeProps(...items) {
+	const ret = {};
+	items.forEach((item) => {
+		if (item) Object.keys(item).forEach((key) => {
+			if (item[key] !== void 0) ret[key] = item[key];
+		});
+	});
+	return ret;
+}
+//#endregion
+export { mergeProps as default };

package/dist/_util/fallbackProp.d.ts

@@ -0,0 +1,13 @@
+//#region src/_util/fallbackProp.d.ts
+/**
+ * Search for the first non-undefined value in the arguments and return it.
+ *
+ * ```js
+ * const mergedIcon = fallbackProp(propIcon, contextIcon, defaultIcon);
+ * ```
+ *
+ * Note: it is different from `??` operator which skips null
+ */
+declare function fallbackProp<T>(...args: T[]): Exclude<T, undefined> | undefined;
+//#endregion
+export { fallbackProp as default };