@v-c/util 1.0.19 → 1.0.20

package/dist/KeyCode.js

@@ -1,109 +1,432 @@
+//#region src/KeyCode.ts
+/**
+* some key-codes definition and utils from closure-library
+* @author yiminghe@gmail.com
+*/
 var KeyCode = {
+	/**
+	* MAC_ENTER
+	*/
 	MAC_ENTER: 3,
+	/**
+	* BACKSPACE
+	*/
 	BACKSPACE: 8,
+	/**
+	* TAB
+	*/
 	TAB: 9,
+	/**
+	* NUMLOCK on FF/Safari Mac
+	*/
 	NUM_CENTER: 12,
+	/**
+	* ENTER
+	*/
 	ENTER: 13,
+	/**
+	* SHIFT
+	*/
 	SHIFT: 16,
+	/**
+	* CTRL
+	*/
 	CTRL: 17,
+	/**
+	* ALT
+	*/
 	ALT: 18,
+	/**
+	* PAUSE
+	*/
 	PAUSE: 19,
+	/**
+	* CAPS_LOCK
+	*/
 	CAPS_LOCK: 20,
+	/**
+	* ESC
+	*/
 	ESC: 27,
+	/**
+	* SPACE
+	*/
 	SPACE: 32,
+	/**
+	* PAGE_UP
+	*/
 	PAGE_UP: 33,
+	/**
+	* PAGE_DOWN
+	*/
 	PAGE_DOWN: 34,
+	/**
+	* END
+	*/
 	END: 35,
+	/**
+	* HOME
+	*/
 	HOME: 36,
+	/**
+	* LEFT
+	*/
 	LEFT: 37,
+	/**
+	* UP
+	*/
 	UP: 38,
+	/**
+	* RIGHT
+	*/
 	RIGHT: 39,
+	/**
+	* DOWN
+	*/
 	DOWN: 40,
+	/**
+	* PRINT_SCREEN
+	*/
 	PRINT_SCREEN: 44,
+	/**
+	* INSERT
+	*/
 	INSERT: 45,
+	/**
+	* DELETE
+	*/
 	DELETE: 46,
+	/**
+	* ZERO
+	*/
 	ZERO: 48,
+	/**
+	* ONE
+	*/
 	ONE: 49,
+	/**
+	* TWO
+	*/
 	TWO: 50,
+	/**
+	* THREE
+	*/
 	THREE: 51,
+	/**
+	* FOUR
+	*/
 	FOUR: 52,
+	/**
+	* FIVE
+	*/
 	FIVE: 53,
+	/**
+	* SIX
+	*/
 	SIX: 54,
+	/**
+	* SEVEN
+	*/
 	SEVEN: 55,
+	/**
+	* EIGHT
+	*/
 	EIGHT: 56,
+	/**
+	* NINE
+	*/
 	NINE: 57,
+	/**
+	* QUESTION_MARK
+	*/
 	QUESTION_MARK: 63,
+	/**
+	* A
+	*/
 	A: 65,
+	/**
+	* B
+	*/
 	B: 66,
+	/**
+	* C
+	*/
 	C: 67,
+	/**
+	* D
+	*/
 	D: 68,
+	/**
+	* E
+	*/
 	E: 69,
+	/**
+	* F
+	*/
 	F: 70,
+	/**
+	* G
+	*/
 	G: 71,
+	/**
+	* H
+	*/
 	H: 72,
+	/**
+	* I
+	*/
 	I: 73,
+	/**
+	* J
+	*/
 	J: 74,
+	/**
+	* K
+	*/
 	K: 75,
+	/**
+	* L
+	*/
 	L: 76,
+	/**
+	* M
+	*/
 	M: 77,
+	/**
+	* N
+	*/
 	N: 78,
+	/**
+	* O
+	*/
 	O: 79,
+	/**
+	* P
+	*/
 	P: 80,
+	/**
+	* Q
+	*/
 	Q: 81,
+	/**
+	* R
+	*/
 	R: 82,
+	/**
+	* S
+	*/
 	S: 83,
+	/**
+	* T
+	*/
 	T: 84,
+	/**
+	* U
+	*/
 	U: 85,
+	/**
+	* V
+	*/
 	V: 86,
+	/**
+	* W
+	*/
 	W: 87,
+	/**
+	* X
+	*/
 	X: 88,
+	/**
+	* Y
+	*/
 	Y: 89,
+	/**
+	* Z
+	*/
 	Z: 90,
+	/**
+	* META
+	*/
 	META: 91,
+	/**
+	* WIN_KEY_RIGHT
+	*/
 	WIN_KEY_RIGHT: 92,
+	/**
+	* CONTEXT_MENU
+	*/
 	CONTEXT_MENU: 93,
+	/**
+	* NUM_ZERO
+	*/
 	NUM_ZERO: 96,
+	/**
+	* NUM_ONE
+	*/
 	NUM_ONE: 97,
+	/**
+	* NUM_TWO
+	*/
 	NUM_TWO: 98,
+	/**
+	* NUM_THREE
+	*/
 	NUM_THREE: 99,
+	/**
+	* NUM_FOUR
+	*/
 	NUM_FOUR: 100,
+	/**
+	* NUM_FIVE
+	*/
 	NUM_FIVE: 101,
+	/**
+	* NUM_SIX
+	*/
 	NUM_SIX: 102,
+	/**
+	* NUM_SEVEN
+	*/
 	NUM_SEVEN: 103,
+	/**
+	* NUM_EIGHT
+	*/
 	NUM_EIGHT: 104,
+	/**
+	* NUM_NINE
+	*/
 	NUM_NINE: 105,
+	/**
+	* NUM_MULTIPLY
+	*/
 	NUM_MULTIPLY: 106,
+	/**
+	* NUM_PLUS
+	*/
 	NUM_PLUS: 107,
+	/**
+	* NUM_MINUS
+	*/
 	NUM_MINUS: 109,
+	/**
+	* NUM_PERIOD
+	*/
 	NUM_PERIOD: 110,
+	/**
+	* NUM_DIVISION
+	*/
 	NUM_DIVISION: 111,
+	/**
+	* F1
+	*/
 	F1: 112,
+	/**
+	* F2
+	*/
 	F2: 113,
+	/**
+	* F3
+	*/
 	F3: 114,
+	/**
+	* F4
+	*/
 	F4: 115,
+	/**
+	* F5
+	*/
 	F5: 116,
+	/**
+	* F6
+	*/
 	F6: 117,
+	/**
+	* F7
+	*/
 	F7: 118,
+	/**
+	* F8
+	*/
 	F8: 119,
+	/**
+	* F9
+	*/
 	F9: 120,
+	/**
+	* F10
+	*/
 	F10: 121,
+	/**
+	* F11
+	*/
 	F11: 122,
+	/**
+	* F12
+	*/
 	F12: 123,
+	/**
+	* NUMLOCK
+	*/
 	NUMLOCK: 144,
+	/**
+	* SEMICOLON
+	*/
 	SEMICOLON: 186,
+	/**
+	* DASH
+	*/
 	DASH: 189,
+	/**
+	* EQUALS
+	*/
 	EQUALS: 187,
+	/**
+	* COMMA
+	*/
 	COMMA: 188,
+	/**
+	* PERIOD
+	*/
 	PERIOD: 190,
+	/**
+	* SLASH
+	*/
 	SLASH: 191,
+	/**
+	* APOSTROPHE
+	*/
 	APOSTROPHE: 192,
+	/**
+	* SINGLE_QUOTE
+	*/
 	SINGLE_QUOTE: 222,
+	/**
+	* OPEN_SQUARE_BRACKET
+	*/
 	OPEN_SQUARE_BRACKET: 219,
+	/**
+	* BACKSLASH
+	*/
 	BACKSLASH: 220,
+	/**
+	* CLOSE_SQUARE_BRACKET
+	*/
 	CLOSE_SQUARE_BRACKET: 221,
+	/**
+	* WIN_KEY
+	*/
 	WIN_KEY: 224,
+	/**
+	* MAC_FF_META
+	*/
 	MAC_FF_META: 224,
+	/**
+	* WIN_IME
+	*/
 	WIN_IME: 229,
+	/**
+	* whether text and modified key is entered at the same time.
+	*/
 	isTextModifyingKeyEvent: function isTextModifyingKeyEvent(e) {
 		const { keyCode } = e;
 		if (e.altKey && !e.ctrlKey || e.metaKey || keyCode >= KeyCode.F1 && keyCode <= KeyCode.F12) return false;
@@ -134,6 +457,9 @@ var KeyCode = {
 			default: return true;
 		}
 	},
+	/**
+	* whether character is entered.
+	*/
 	isCharacterKey: function isCharacterKey(keyCode) {
 		if (keyCode >= KeyCode.ZERO && keyCode <= KeyCode.NINE) return true;
 		if (keyCode >= KeyCode.NUM_ZERO && keyCode <= KeyCode.NUM_MULTIPLY) return true;
@@ -161,8 +487,7 @@ var KeyCode = {
 		}
 	}
 };
-var KeyCode_default = KeyCode;
-const KeyCodeStr = {
+var KeyCodeStr = {
 	Enter: "Enter",
 	Backspace: "Backspace",
 	Tab: "Tab",
@@ -242,4 +567,5 @@ const KeyCodeStr = {
 	BracketRight: "]",
 	Quote: "'"
 };
-export { KeyCodeStr, KeyCode_default as default };
+//#endregion
+export { KeyCodeStr, KeyCode as default };

package/dist/Portal.js

@@ -1,6 +1,7 @@
 import canUseDom from "./Dom/canUseDom.js";
 import { Teleport, createVNode, defineComponent, onBeforeUnmount, onMounted, onUnmounted, shallowRef } from "vue";
-var Portal_default = /* @__PURE__ */ defineComponent((props, ctx) => {
+//#region src/Portal.tsx
+var Portal = /* @__PURE__ */ defineComponent((props, ctx) => {
 	const parentRef = shallowRef();
 	const containerRef = shallowRef();
 	const initRef = shallowRef(false);
@@ -31,10 +32,10 @@ var Portal_default = /* @__PURE__ */ defineComponent((props, ctx) => {
 		},
 		getContainer: {
 			type: Function,
-			required: true,
-			default: void 0
+			required: true
 		}
 	},
 	inheritAttrs: false
 });
-export { Portal_default as default };
+//#endregion
+export { Portal as default };

package/dist/PortalWrapper.d.ts

@@ -23,6 +23,6 @@ interface PortalWrapperEmits {
     [key: string]: any;
 }
 declare const PortalWrapper: import('vue').DefineSetupFnComponent<PortalWrapperProps, PortalWrapperEmits, DefaultSlotInfo, PortalWrapperProps & {
-    [x: `on${Capitalize<string>}`]: (...args: any[] | unknown[]) => any;
+    [x: `on${Capitalize<string>}`]: (...args: any) => any;
 }, import('vue').PublicProps>;
 export default PortalWrapper;

package/dist/PortalWrapper.js

@@ -1,11 +1,15 @@
 import canUseDom from "./Dom/canUseDom.js";
-import Portal_default from "./Portal.js";
-import setStyle_default from "./setStyle.js";
+import Portal from "./Portal.js";
+import setStyle from "./setStyle.js";
 import ScrollLocker from "./Dom/scrollLocker.js";
-import raf_default from "./raf.js";
+import wrapperRaf from "./raf.js";
 import { createVNode, defineComponent, onBeforeUnmount, onMounted, onUpdated, shallowRef } from "vue";
+//#region src/PortalWrapper.tsx
 var openCount = 0;
 var supportDom = canUseDom();
+/**
+* @private
+*/
 function getOpenCount() {
 	return process.env.NODE_ENV === "test" ? openCount : 0;
 }
@@ -19,7 +23,7 @@ function getParent(getContainer) {
 	}
 	return document.body;
 }
-var PortalWrapper_default = /* @__PURE__ */ defineComponent((props, ctx) => {
+var PortalWrapper = /* @__PURE__ */ defineComponent((props, ctx) => {
 	const container = shallowRef();
 	const componentRef = shallowRef();
 	const rafId = shallowRef();
@@ -29,12 +33,12 @@ var PortalWrapper_default = /* @__PURE__ */ defineComponent((props, ctx) => {
 	};
 	const updateOpenCount = (prevProps) => {
 		const { visible: prevVisible, getContainer: prevGetContainer } = prevProps || {};
-		const { visible, getContainer: getContainer$1 } = props;
-		if (visible !== prevVisible && supportDom && getParent(getContainer$1) === document.body) {
+		const { visible, getContainer } = props;
+		if (visible !== prevVisible && supportDom && getParent(getContainer) === document.body) {
 			if (visible && !prevVisible) openCount += 1;
 			else if (prevProps) openCount -= 1;
 		}
-		if (typeof getContainer$1 === "function" && typeof prevGetContainer === "function" ? getContainer$1.toString() !== prevGetContainer.toString() : getContainer$1 !== prevGetContainer) removeCurrentContainer();
+		if (typeof getContainer === "function" && typeof prevGetContainer === "function" ? getContainer.toString() !== prevGetContainer.toString() : getContainer !== prevGetContainer) removeCurrentContainer();
 	};
 	const attachToParent = (force = false) => {
 		if (force || container.value && !container.value.parentNode) {
@@ -63,7 +67,7 @@ var PortalWrapper_default = /* @__PURE__ */ defineComponent((props, ctx) => {
 	onMounted(() => {
 		scrollLocker.value = new ScrollLocker({ container: getParent(props.getContainer) });
 		updateOpenCount();
-		if (!attachToParent()) rafId.value = raf_default(() => {});
+		if (!attachToParent()) rafId.value = wrapperRaf(() => {});
 	});
 	onUpdated(() => {
 		updateOpenCount(props);
@@ -72,21 +76,29 @@ var PortalWrapper_default = /* @__PURE__ */ defineComponent((props, ctx) => {
 		attachToParent();
 	});
 	onBeforeUnmount(() => {
-		const { visible, getContainer: getContainer$1 } = props;
-		if (supportDom && getParent(getContainer$1) === document.body) openCount = visible && openCount ? openCount - 1 : openCount;
+		const { visible, getContainer } = props;
+		if (supportDom && getParent(getContainer) === document.body) openCount = visible && openCount ? openCount - 1 : openCount;
 		removeCurrentContainer();
-		raf_default.cancel(rafId.value);
+		wrapperRaf.cancel(rafId.value);
 	});
+	/**
+	* Enhance ./switchScrollingEffect
+	* 1. Simulate document body scroll bar with
+	* 2. Record body has overflow style and recover when all of PortalWrapper invisible
+	* 3. Disable body scroll when PortalWrapper has open
+	*
+	* @memberof PortalWrapper
+	*/
 	const switchScrollingEffect = () => {
 		if (openCount === 1 && !Object.keys(cacheOverflow).length) {
 			switchScrollingEffect();
-			cacheOverflow = setStyle_default({
+			cacheOverflow = setStyle({
 				overflow: "hidden",
 				overflowX: "hidden",
 				overflowY: "hidden"
 			});
 		} else if (!openCount) {
-			setStyle_default(cacheOverflow);
+			setStyle(cacheOverflow);
 			cacheOverflow = {};
 			switchScrollingEffect();
 		}
@@ -100,7 +112,7 @@ var PortalWrapper_default = /* @__PURE__ */ defineComponent((props, ctx) => {
 			switchScrollingEffect,
 			scrollLocker: scrollLocker.value
 		};
-		if (forceRender || visible || componentRef.value) portal = createVNode(Portal_default, {
+		if (forceRender || visible || componentRef.value) portal = createVNode(Portal, {
 			"getContainer": getContainer,
 			"ref": componentRef
 		}, { default: () => [ctx?.slots?.default(childProps)] });
@@ -129,4 +141,5 @@ var PortalWrapper_default = /* @__PURE__ */ defineComponent((props, ctx) => {
 		default: void 0
 	}
 } });
-export { PortalWrapper_default as default, getOpenCount };
+//#endregion
+export { PortalWrapper as default, getOpenCount };

package/dist/RenderComponent.js

@@ -1,30 +1,32 @@
 import { filterEmpty } from "./props-util/index.js";
 import { createVNode, defineComponent, isVNode } from "vue";
+//#region src/RenderComponent.ts
 function checkIsBaseType(value) {
 	if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return true;
 	return typeof value === "undefined" || value === null;
 }
 var RenderComponent_default = defineComponent((props, { attrs }) => {
 	return () => {
-		const render$1 = props.render;
-		if (render$1 && typeof render$1 === "function") {
-			const _render = render$1?.();
+		const render = props.render;
+		if (render && typeof render === "function") {
+			const _render = render?.();
 			if (Array.isArray(_render)) return filterEmpty(_render).map((v) => {
 				if (isVNode(v)) return createVNode(v, { ...attrs });
 				else return v;
 			});
 			return _render;
-		} else if (Array.isArray(render$1)) return filterEmpty(render$1).map((v) => {
+		} else if (Array.isArray(render)) return filterEmpty(render).map((v) => {
 			if (isVNode(v)) return createVNode(v, { ...attrs });
 			return v;
 		});
-		else if (checkIsBaseType(render$1)) return render$1;
-		if (isVNode(render$1)) return createVNode(render$1, { ...attrs });
-		return render$1;
+		else if (checkIsBaseType(render)) return render;
+		if (isVNode(render)) return createVNode(render, { ...attrs });
+		return render;
 	};
 }, {
 	inheritAttrs: false,
 	name: "RenderComponent",
 	props: ["render"]
 });
+//#endregion
 export { RenderComponent_default as default };

package/dist/classnames.js

@@ -1,3 +1,4 @@
+//#region src/classnames.ts
 function toVal(mix) {
 	let str = "";
 	if (typeof mix === "string" || typeof mix === "number") str += mix;
@@ -31,5 +32,6 @@ function classNames(...args) {
 	}
 	return str;
 }
-const clsx = classNames;
+var clsx = classNames;
+//#endregion
 export { clsx, classNames as default };

package/dist/composeProps.js

@@ -1,3 +1,4 @@
+//#region src/composeProps.ts
 function composeProps(originProps, patchProps, isAll) {
 	const composedProps = {
 		...originProps,
@@ -12,5 +13,5 @@ function composeProps(originProps, patchProps, isAll) {
 	});
 	return composedProps;
 }
-var composeProps_default = composeProps;
-export { composeProps_default as default };
+//#endregion
+export { composeProps as default };

package/dist/createRef.js

@@ -1,3 +1,4 @@
+//#region src/createRef.ts
 function createRef() {
 	const func = (node) => {
 		func.current = node;
@@ -8,6 +9,9 @@ function fillRef(ref, node) {
 	if (typeof ref === "function") ref(node);
 	else if (typeof ref === "object" && ref && "current" in ref) ref.current = node;
 }
+/**
+* Merge refs into one ref function to support ref passing.
+*/
 function composeRef(...refs) {
 	return (node) => {
 		refs.forEach((ref) => {
@@ -15,5 +19,5 @@ function composeRef(...refs) {
 		});
 	};
 }
-var createRef_default = createRef;
-export { composeRef, createRef_default as default, fillRef };
+//#endregion
+export { composeRef, createRef as default, fillRef };

package/dist/debug/diff.js

@@ -1,3 +1,4 @@
+//#region src/debug/diff.ts
 function createArray() {
 	const arr = [];
 	arr.__proto__ = [];
@@ -14,7 +15,7 @@ function createArray() {
 }
 function diff(obj1, obj2, depth = 10, path = [], diffList = createArray()) {
 	if (depth <= 0) return diffList;
-	new Set([...Object.keys(obj1), ...Object.keys(obj2)]).forEach((key) => {
+	(/* @__PURE__ */ new Set([...Object.keys(obj1), ...Object.keys(obj2)])).forEach((key) => {
 		const value1 = obj1[key];
 		const value2 = obj2[key];
 		if (value1 === value2) return;
@@ -40,4 +41,5 @@ function diff(obj1, obj2, depth = 10, path = [], diffList = createArray()) {
 	});
 	return diffList;
 }
+//#endregion
 export { diff as default };

package/dist/deprecated.js

@@ -1,4 +1,6 @@
+//#region src/deprecated.ts
 function deprecated(props, instead, component) {
 	if (typeof window !== "undefined" && window.console && window.console.error) window.console.error(`Warning: ${props} is deprecated at [ ${component} ], use [ ${instead} ] instead of it.`);
 }
+//#endregion
 export { deprecated as default };